โฆษณาแบบข้ามได้ของสตรีม VOD

คู่มือนี้สาธิตวิธีใช้ DAI API เพื่อขอสตรีม VOD ที่มีโฆษณาที่ข้ามได้ แสดงผลปุ่มข้ามตาม ข้อกำหนดของ Google Ads และส่งเหตุการณ์การติดตามที่เกี่ยวข้อง

สิ่งที่ต้องดำเนินการก่อน

สร้างคำขอสำหรับโฆษณาแบบข้ามได้

หากต้องการขอสตรีม 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 รายการช่วงพักโฆษณา
start (ตัวเลข) จัดตำแหน่งช่วงพักในสตรีมที่จะเริ่มในหน่วยวินาที
duration (ตัวเลข) ระยะเวลาของช่วงพักโฆษณาเป็นวินาที
ads (object(Ad)) รายการโฆษณาในสตรีม
start (ตัวเลข) ตำแหน่งในสตรีมที่โฆษณาเริ่มต้นขึ้น โดยมีหน่วยเป็นวินาที
duration (number) ระยะเวลาของโฆษณาเป็นวินาที
skip_metadata (object(ข้ามMetadata)) ข้อมูลเมตาที่ไม่บังคับสำหรับโฆษณาที่ข้ามได้ หากตั้งค่า ข้อมูลนี้จะระบุว่าโฆษณาเป็นแบบข้ามได้และมีวิธีการจัดการ UI การข้ามและเหตุการณ์การติดตาม
offset (ตัวเลข) ออฟเซ็ตจะแสดงระยะเวลาเป็นวินาทีที่เล่นโฆษณาที่โปรแกรมเล่นควรรอให้ปุ่มข้ามแสดงผล ละเว้นหากไม่ได้ระบุใน VAST
tracking_url (สตริง) URL ที่ควรใช้คำสั่ง ping ในเหตุการณ์การข้าม

ตัวอย่างการตอบกลับ

{
  ...
  "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 เพื่อแปลข้อความ "ข้ามโฆษณา" ตามภาษาของผู้ใช้