ดูข้อมูลเกี่ยวกับ Stream Activity Monitor API

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