เริ่มต้นใช้งาน SGAI สําหรับสตรีมแบบสด

การแทรกโฆษณาที่เซิร์ฟเวอร์แนะนำ (SGAI) จะให้ไฟล์ Manifest ของพ็อดโฆษณาที่พร้อมสำหรับการ เย็บรวมในอุปกรณ์ไคลเอ็นต์ หากเปิดใช้ DAI ที่แสดงพ็อดในเครือข่าย Google Ad Manager คุณจะมีสิทธิ์ใช้ SGAI หากไม่ได้เปิดใช้ Pod Serving DAI โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้า

เมื่อใช้ SGAI คุณจะใช้ปลายทาง API การแสดงพ็อดเพื่อสร้างสตรีม เรียกข้อมูลเมตาของโฆษณาและไฟล์ Manifest ของพ็อดโฆษณา

หากมีเซิร์ฟเวอร์การจัดการไฟล์ Manifest คุณจะสร้าง URL ของไฟล์ Manifest ของพ็อดโฆษณาและแทรกเครื่องหมายโฆษณาที่มีข้อมูลไฟล์ Manifest ของพ็อดโฆษณาในสตรีมเนื้อหาได้ตามข้อกำหนดที่คุณต้องการ

หรือคุณจะกำหนดเวลาช่วงพักโฆษณาโดยใช้กลไกอื่นนอกเหนือจากเครื่องหมายโฆษณาในไฟล์ Manifest ของสตรีมก็ได้ ในกรณีเหล่านี้ แอปของคุณสามารถฟัง เหตุการณ์อื่นๆ ได้ เช่น การโต้ตอบของผู้ใช้กับสตรีม ตัวแอปเอง หรือการแจ้งเตือนแบบพุช หลังจากเหตุการณ์เหล่านี้ แอปจะสร้าง URL ของไฟล์ Manifest ของพ็อดโฆษณาและบอกให้เพลเยอร์เริ่มโหลดไฟล์ Manifest ของพ็อดโฆษณาได้

ข้อกำหนดเบื้องต้น

ก่อนดำเนินการต่อ โปรดตรวจสอบว่าคุณมีสิ่งต่อไปนี้

  • เปิดใช้การแสดงโฆษณาพ็อด DAI ในเครือข่าย Ad Manager ของ Google
  • เหตุการณ์ไลฟ์สดที่มีประเภทเป็น Pod serving manifest หากต้องการสร้างกิจกรรม โปรดดู ตั้งค่าไลฟ์สดสำหรับ DAI

ทำตามคำแนะนำ

ก่อนที่จะสร้าง URL ของไฟล์ Manifest ของพ็อดโฆษณา เราขอแนะนำให้คุณเรียกใช้ API การแจ้งเตือนช่วงพักโฆษณาตอนต้น (EABN) เพื่อระบุระยะเวลาที่คาดไว้ ข้อมูลการกำหนดเป้าหมาย และพารามิเตอร์อื่นๆ ของช่วงพักโฆษณาแต่ละช่วง

สำหรับสตรีมที่ใช้งานจริงและสตรีมทดสอบ ให้เรียกใช้ EABN API โดยเฉพาะหากเครือข่ายโฆษณามีแคมเปญแบบเป็นโปรแกรม ดูข้อมูลเพิ่มเติมได้ที่ ฟีเจอร์และหลักเกณฑ์สำหรับการขายตรงแบบเป็นโปรแกรม

ส่งคำขอลงทะเบียนสตรีม

เมื่อผู้ใช้เริ่มสตรีมเนื้อหาในแอปวิดีโอเพลเยอร์ คุณจะส่งคำขอลงทะเบียนสตรีมพร้อมพารามิเตอร์การกำหนดเป้าหมายเพื่อสร้างเซสชันการสตรีมใน Ad Manager โปรดดูรายละเอียดเกี่ยวกับการส่งคำขอลงทะเบียนสตรีมที่ Method:stream หลังจากนั้น คุณจะได้รับข้อมูลการตอบกลับ จากคำขอ

ตัวอย่างต่อไปนี้จะส่งคำขอลงทะเบียนสตรีม

HTTP ข้อความธรรมดา

  • คำขอ
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
  • คำตอบ:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

เปลือกหอย

  • บรรทัดคำสั่ง:
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
  • เอาต์พุต:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

JavaScript

  • การใช้ Fetch API
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);
  • บันทึกคอนโซล:
{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

สำรวจข้อมูลเมตาของช่วงพักโฆษณา

หลังจากส่งคำขอลงทะเบียนสตรีมแล้ว ให้สำรวจข้อมูลเมตาของโฆษณา หากต้องการ สำรวจความคิดเห็น ให้ตั้งเวลานับถอยหลังโดยใช้polling_frequenceในคำตอบในสตรีมที่ ขั้นตอนการลงทะเบียนเพื่อเรียกข้อมูลเมตาของโฆษณา คุณอาจได้รับรายการโฆษณาบางส่วนพร้อมข้อมูลเมตาสำหรับแต่ละโพลเมื่อโฆษณาพร้อมใช้งาน

สร้าง URL ของไฟล์ Manifest ของพ็อดโฆษณา

สร้าง URL สำหรับ ทรัพยากรพ็อด ของ Pod Serving API หลังจากนั้น ให้ส่ง URL ไปยังวิดีโอเพลเยอร์เพื่อเริ่ม โหลดพ็อดโฆษณา

ตัวอย่างต่อไปนี้แสดงโครงสร้างของ URL ไฟล์ Manifest ของพ็อดโฆษณา

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/ad_break_id/ab101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

คุณสามารถคำนวณพารามิเตอร์ URL ของไฟล์ Manifest ของพ็อดโฆษณาตามข้อมูลช่วงพักโฆษณา ที่ดึงมาจากวิดีโอเพลเยอร์หรือการแจ้งเตือนจากเซิร์ฟเวอร์ ดูข้อกำหนดของพารามิเตอร์เหล่านี้ได้ที่ วิธี: ไฟล์ Manifest ของ Pod

เล่นไฟล์ Manifest ของพ็อดโฆษณา

ในแอปวิดีโอเพลเยอร์ฝั่งไคลเอ็นต์ ให้เริ่มการเล่นสตรีมเนื้อหาด้วยวิดีโอเพลเยอร์หลัก และทำตามเอกสารประกอบของวิดีโอเพลเยอร์เกี่ยวกับการสังเกต การเล่นและกำหนดเวลาโฆษณา หากเกี่ยวข้อง

หากคุณสร้าง URL ของไฟล์ Manifest ของพ็อดโฆษณาและแทรกลงในไฟล์ Manifest ที่ฝั่งเซิร์ฟเวอร์ ให้สังเกตเหตุการณ์ช่วงพักโฆษณาที่กำลังจะมาถึงของวิดีโอเพลเยอร์ และอย่าลืมสมัครใช้เหตุการณ์ ID3 ในระหว่างการเล่นช่วงพักโฆษณาแต่ละครั้ง หากคุณกำหนดเวลากิจกรรมช่วงพักโฆษณาจากฝั่งไคลเอ็นต์ ให้ติดตามกิจกรรม ID3 เมื่อสร้าง

รายงานการแสดงผลและเหตุการณ์โฆษณา

เมื่อวิดีโอเพลเยอร์เล่นพ็อดโฆษณาและพบข้อมูลเมตาที่กำหนดเวลาไว้ของ ID3 ให้ฟังเหตุการณ์โฆษณา ที่วิดีโอเพลเยอร์ทริกเกอร์และประมวลผลเพื่อ ส่งคำสั่ง ping การยืนยันสื่อ