API เครื่องมือตรวจสอบกิจกรรมการสตรีม (SAM) ของการแทรกโฆษณาแบบไดนามิก (DAI) ช่วยให้คุณตรวจสอบและแก้ปัญหาเซสชันการดูไลฟ์สดและวิดีโอออนดีมานด์ (VOD) แต่ละรายการได้
หากต้องการตรวจสอบและแก้ปัญหาเซสชันการดูไลฟ์สดหรือ VOD แต่ละรายการด้วยตนเอง ให้ใช้เครื่องมือตรวจสอบกิจกรรมการสตรีมใน UI ของ Google Ad Manager
หากต้องการดึงข้อมูลการวินิจฉัยสำหรับเซสชันแบบเป็นโปรแกรม ให้ใช้ทรัพยากร networks.daiSessions ของ Ad Manager API
ทำความเข้าใจกรณีการใช้งาน
SAM API ช่วยให้คุณวิเคราะห์สตรีมและแก้ไขปัญหาการแสดงโฆษณาในการผสานรวม DAI ได้โดยอัตโนมัติ เช่น
- ยืนยันการสร้างเซสชันสตรีม: ยืนยันพารามิเตอร์ โหมดการต่อของ
STITCHEDหรือPOD_SERVINGโหมดการรายงาน และข้อมูลเมตาของเนื้อหาที่ Google DAI ได้รับเมื่อสร้างเซสชันไลฟ์สดหรือ VOD - ตรวจสอบคำขอโฆษณาและการตอบกลับ: ตรวจสอบแท็กโฆษณาเทมเพลตการแสดงโฆษณาวิดีโอ (VAST) และเพลย์ลิสต์โฆษณาหลายรายการสำหรับวิดีโอ (VMAP) ขาออก, รหัสสถานะ HTTP, เวลาในการตอบสนอง, เนื้อหาการตอบกลับ XML ดิบ และเชนการเปลี่ยนเส้นทาง Wrapper
- แก้ปัญหาการตัดสินใจและครีเอทีฟโฆษณาของพ็อดโฆษณา: ตรวจสอบโฆษณาที่ Google DAI เลือกหรือทิ้งสำหรับแต่ละพ็อด ระยะเวลาของโฆษณาแต่ละรายการในพ็อด และระบบโฆษณาแหล่งที่มาของครีเอทีฟโฆษณา
- ติดตามการดำเนินการดึงข้อมูลโฆษณาล่วงหน้า: ตรวจสอบว่า DAI ของ Google ดึงข้อมูลพ็อดโฆษณาล่วงหน้าหรือไม่ และตรวจสอบขั้นตอนการดึงข้อมูลล่วงหน้าของพ็อดโฆษณาแต่ละรายการ
- ตรวจสอบ DAI Ad Break API และการเรียก DAI API สำหรับการแสดงพ็อด: ตรวจสอบการดำเนินการช่วงพักโฆษณาจริง ระยะเวลาของโฆษณาที่แสดง และระยะเวลาของแถบสเลทที่แทรกเทียบกับการเรียก API เช่น DAI Ad Break API และ DAI API สำหรับการแสดงพ็อด
- ยืนยันการติดตามเหตุการณ์โฆษณา: ตรวจสอบว่าคําสั่ง ping การติดตามฝั่งไคลเอ็นต์หรือฝั่งเซิร์ฟเวอร์สําเร็จหรือไม่ และตรวจสอบการตอบกลับ HTTP จากเซิร์ฟเวอร์โฆษณา
- ตรวจสอบเซสชันและแจ้งเตือนโดยอัตโนมัติ: แยกวิเคราะห์รายการผลการค้นหาที่มีโครงสร้างซึ่งมีความรุนแรงระดับ
INFO,WARNINGหรือERRORเพื่อตรวจหาปัญหาเกี่ยวกับการเล่นหรือการสร้างรายได้ในการทดสอบการผสานรวมอัตโนมัติและไปป์ไลน์การตรวจสอบการผลิต
ดูข้อมูลเกี่ยวกับแหล่งข้อมูลระดับบนสุด
SAM API เป็นส่วนหนึ่งของ Google Ad Manager REST API (เบต้า) ในปลายทาง admanager.googleapis.com และแสดงเมธอด networks.daiSessions.get แบบอ่านอย่างเดียว คุณสามารถค้นหาทรัพยากร DaiSession ด้วยรหัสเซสชัน DAI หรือคีย์การแก้ไขข้อบกพร่องที่กำหนดเอง DAI จะเก็บรักษาบันทึกเซสชันไว้เป็นเวลาสูงสุด 3 วันหลังจากการเล่น
SAM API ไม่รองรับการแสดงรายการทรัพยากร DaiSession ทั้งหมดในเครือข่าย Google Ad Manager
ตรวจสอบการตอบกลับสตรีม DAI ด้วย SAM
หากต้องการตรวจสอบวิธีที่ DAI ของ Google ประมวลผลคำขอสตรีม ให้ตรวจสอบการตอบกลับ DaiSession ดังนี้
- DAI API แบบบริการเต็มรูปแบบ: ตรวจสอบช่อง
creationContext.streamCreateRequestเพื่อยืนยันการเรียกการลงทะเบียนสตรีม ตรวจสอบแผนที่adSelectionsและadPodsเพื่อตรวจสอบการตัดสินใจแสดงโฆษณา และตรวจสอบแผนที่adBreaksเพื่อยืนยันระยะเวลาของโฆษณาที่เย็บติด ครีเอทีฟโฆษณาแถบสเลท และเนื้อหาหลัก - Pod Serving DAI API: ตรวจสอบว่าช่อง
creationContext.stitchingTypeตั้งค่าเป็นค่าPOD_SERVING, ตรวจสอบช่องadBreakIdในแผนที่adPodsและadBreaksกับไฟล์ Manifest ของพ็อดหรือการเรียกคำขอเซกเมนต์พ็อด และตรวจสอบบีคอนฝั่งเซิร์ฟเวอร์หรือบีคอนการยืนยันสื่อในแผนที่trackingPings - DAI Ad Break API: จับคู่ค่า
breakSequenceของออบเจ็กต์AdBreakกับพร็อพเพอร์ตี้AdBreak.breakSequence
ส่งคำขอแรก
หากต้องการตั้งค่าการตรวจสอบสิทธิ์และดึงข้อมูลทรัพยากรเซสชัน DAI โปรดดูหัวข้อใช้ Stream Activity Monitor API