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

คู่มือนี้แสดงวิธีใช้ 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

รายการช่วงพักโฆษณา start (ตัวเลข) จัดตำแหน่งช่วงพักในสตรีมที่จะเริ่มในหน่วยวินาที duration (ตัวเลข) ระยะเวลาของช่วงพักโฆษณาเป็นวินาที ads (object(Ad)) รายการโฆษณาในสตรีม start (ตัวเลข) ตำแหน่งในสตรีมที่โฆษณาเริ่มต้น วินาที duration (number) ระยะเวลาของโฆษณาเป็นวินาที skip_metadata (object(SkipMetadata)) ข้อมูลเมตาที่ไม่บังคับสำหรับการข้ามได้ ทั้งหมด หากตั้งค่าไว้ กรณีนี้หมายความว่าโฆษณาสามารถข้ามได้และประกอบด้วย วิธีจัดการ 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 สำหรับการแปล "ข้ามโฆษณา" ข้อความตามภาษาของผู้ใช้