คู่มือนี้สาธิตวิธีใช้ DAI API เพื่อขอสตรีม VOD ที่มีโฆษณาที่ข้ามได้ แสดงผลปุ่มข้ามตาม ข้อกำหนดของ Google Ads และส่งเหตุการณ์การติดตามที่เกี่ยวข้อง
สิ่งที่ต้องดำเนินการก่อน
- แอปที่ใช้การเรียก DAI API สำหรับสตรีม VOD ดูข้อมูลเพิ่มเติมได้ในคู่มือสตรีม DAI API VOD
สร้างคำขอสำหรับโฆษณาแบบข้ามได้
หากต้องการขอสตรีม VOD ที่มีโฆษณาที่ข้ามได้ คุณต้องส่งพารามิเตอร์ dai-sas
ในคำขอสตรีม
ปลายทาง API
POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded
พารามิเตอร์เส้นทาง
{CMS_ID} |
รหัส CMS ของสตรีม |
{VIDEO_ID} |
รหัสวิดีโอของสตรีม |
พารามิเตอร์ร่างกาย
dai-sas |
ตั้งค่า dai-sas=1 เพื่อเปิดใช้โฆษณาแบบข้ามได้
|
ตัวอย่างคำขอ (cURL)
สำหรับคำขอสตรีม HLS ให้ทำดังนี้
curl -X POST \
-d 'dai-sas=1' \
-H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
แทนที่ 'dash'
ใน URL สำหรับสตรีม DASH ดังนี้
https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream
ใช้รูปแบบต่อไปนี้เพื่อรวมพารามิเตอร์สตรีมหลายรายการในเนื้อหาคำขอ
-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \
จัดการกับโฆษณาที่ข้าม
หากต้องการจัดการการข้ามโฆษณา ให้ใช้ข้อมูลในโครงสร้าง Ad
หรือโครงสร้าง AdBreak
โดยขึ้นอยู่กับว่าคุณจะข้ามโฆษณาปัจจุบันหรือช่วงพักโฆษณาทั้งช่วง
นำค่า start
ไปบวกค่า duration
จากนั้นกรอไปยังจุดนั้นในสตรีม ข้อความย่อย SkipMetadata
ยังรวมค่า offset
ซึ่งเป็นค่าเป็นวินาทีก่อนที่จะข้ามโฆษณาได้ ข้อความย่อย SkipMetadata
จะรวมอยู่ในโฆษณาที่ข้ามได้เท่านั้น
ad_breaks |
รายการช่วงพักโฆษณา
|
ตัวอย่างการตอบกลับ
{
...
"ad_breaks":[
{
...
"start":0,
"duration":10,
"ads":[
{
...
"start":0,
"duration":10,
"skip_metadata":{
"offset": 5,
"tracking_url": "https://example_skip_url.com"
}
}
}
}
เมื่อโฆษณาข้ามแล้ว ระบบจะใช้คำสั่ง ping กับ URL ของเหตุการณ์การข้ามที่อยู่ในการตอบกลับของสตรีม
ซึ่งรวมอยู่ในข้อความย่อย SkipMetadata
ข้อกำหนดของปุ่มข้าม
สำหรับโฆษณาแบบข้ามได้ ให้แสดงผลปุ่มข้ามด้วยข้อกำหนดการออกแบบดังต่อไปนี้ การไม่ปฏิบัติตามข้อกำหนดเหล่านี้อาจทำให้เกิดข้อจำกัดในการแสดงโฆษณา Google บนเว็บไซต์หรือแอปของคุณ
ตัวจับเวลาถอยหลัง
โฆษณาต้องข้ามไม่ได้จนกว่าจะถึงเวลา skipoffset
ที่ระบุไว้ใน VAST
ในช่วงเวลาที่ข้ามไม่ได้นี้ คุณต้องแสดงการแจ้งให้ผู้ใช้ทราบเพื่อแจ้งว่าคุณสามารถข้ามโฆษณาได้ใน X วินาที ประกาศต้องแปลเป็นภาษาของผู้ใช้
ตำแหน่งของปุ่มข้าม
สำหรับภาษาที่อ่านจากซ้ายไปขวา ให้วางปุ่มข้ามที่ด้านล่างขวาของโปรแกรมเล่นวิดีโอ สำหรับภาษาที่อ่านจากขวาไปซ้าย ให้วางปุ่มข้ามที่ด้านล่างซ้ายของโปรแกรมเล่นวิดีโอ
ขนาดของปุ่มข้าม
ปุ่มและข้อความต้องใหญ่พอที่จะอ่านออกได้อย่างชัดเจนในประสบการณ์แบบเอนหลัง
ข้อความและไอคอน
ปุ่มข้ามต้องมีทั้งข้อความและลักษณะสัญลักษณ์ โดยคุณสามารถใช้ปุ่มข้ามไอคอนสื่อการเรียนการสอนของชั้นเรียนถัดไปเพื่อแสดงการตีความสัญลักษณ์ได้
การช่วยเหลือพิเศษ
ผู้ใช้ควรไปยังปุ่มข้ามได้โดยใช้แป้นพิมพ์หรือรีโมตคอนโทรล แอปควรโฟกัสปุ่มข้ามเมื่อการนับถอยหลังเสร็จสมบูรณ์
การก้าวสู่ระดับสากล
ขอแนะนำให้แปลข้อความที่ข้ามเป็นภาษาของผู้ใช้
พ็อดโฆษณา
คุณสามารถใช้ปุ่มข้ามเพื่อข้ามโฆษณาปัจจุบันในพ็อดโฆษณาหรือข้ามทั้งพ็อดก็ได้
คำแปล "ข้ามโฆษณา"
ใช้ไฟล์ skipAdTranslations.json
เพื่อแปลข้อความ "ข้ามโฆษณา" ตามภาษาของผู้ใช้