เปิดใช้โฆษณาแบบข้ามได้ในสตรีม VOD

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

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

• แอปที่ใช้การเรียก DAI API สําหรับสตรีม VOD ดูข้อมูลเพิ่มเติมได้ที่หัวข้อขอสตรีม VOD ของ DAI

ส่งคําขอโฆษณาแบบข้ามได้

หากต้องการขอสตรีม 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 struct หรือ AdBreak struct โดยขึ้นอยู่กับว่าคุณข้ามโฆษณาปัจจุบันหรือช่วงพักโฆษณาทั้งหมด นำค่า start มาบวกค่า duration แล้วกรอไปยังจุดนั้นในสตรีม ข้อความย่อย SkipMetadata ยังมีค่า offset ด้วย ซึ่งเป็นค่าเป็นวินาทีของเวลาที่ผู้ใช้จะข้ามโฆษณาได้ ข้อความย่อย SkipMetadata จะรวมอยู่ในโฆษณาแบบข้ามได้เท่านั้น

ad_breaks

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

ตำแหน่งปุ่มข้าม

สำหรับภาษาที่อ่านจากซ้ายไปขวา ให้วางปุ่มข้ามที่ด้านขวาล่างของโปรแกรมเล่นวิดีโอ สำหรับภาษาที่เขียนจากขวาไปซ้าย ให้วางปุ่มข้ามที่ด้านซ้ายล่างของวิดีโอเพลเยอร์

ขนาดปุ่มข้าม

ปุ่มและข้อความต้องใหญ่พอที่จะอ่านออกได้อย่างชัดเจนในประสบการณ์การใช้งานแบบ Lean-back

ข้อความและไอคอน

ปุ่มข้ามต้องมีทั้งข้อความและไอคอน คุณสามารถใช้ไอคอนข้ามเนื้อหาถัดไปเป็นไอคอนได้

การช่วยเหลือพิเศษ

ผู้ใช้ควรไปยังปุ่มข้ามได้โดยใช้แป้นพิมพ์หรือรีโมตคอนโทรล แอปควรโฟกัสที่ปุ่มข้ามเมื่อหมดเวลานับถอยหลังแล้ว

การทำให้เป็นสากล

เราขอแนะนำให้แปลข้อความข้ามเป็นภาษาของผู้ใช้

พ็อดโฆษณา

ปุ่มข้ามสามารถใช้เพื่อข้ามโฆษณาปัจจุบันในพ็อดโฆษณา หรือข้ามทั้งพ็อด

คำแปล "ข้ามโฆษณา"

ใช้ไฟล์ skipAdTranslations.json เพื่อแปลข้อความ "ข้ามโฆษณา" ตามภาษาของผู้ใช้