เริ่มต้นใช้งาน SGAI

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

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

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

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

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

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

  • เปิดใช้การแสดงพ็อด DAI ในเครือข่าย Google Ad Manager ของคุณแล้ว
  • เหตุการณ์สตรีมแบบสดที่มีประเภทไฟล์ 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

  • การใช้ 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 ในการตอบกลับสตรีมที่เวลา ขั้นตอนการลงทะเบียนเพื่อเรียกโฆษณา metadata สำหรับแบบสำรวจแต่ละรายการ คุณอาจได้รับรายการบางส่วนของโฆษณาที่มีข้อมูลเมตาเนื่องจาก พร้อมให้บริการ

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

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

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

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

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

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

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

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

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

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