מודעות ניתנות לדילוג בסטרימינג ב-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 (number) המיקום בזרם שבו מתחיל ההפסקה, בשניות.
duration (מספר) משך ההפסקה למודעה, בשניות.
ads (object(Ad) רשימה של מודעות בזרם.
start (number) המיקום בזרם שבו המודעה מתחילה, בשניות.
duration (number) משך המודעה, בשניות.
skip_metadata (object(SkipMetadata) מטא-נתונים אופציונליים למודעות שניתנות לדילוג. אם מגדירים את הפרמטר הזה, המשמעות היא שניתן לדלג על המודעה, וכוללת הוראות לטיפול בממשק המשתמש של הדילוג ובאירוע המעקב.
offset (number) הערך שמציין את ההיסט מציין את משך הזמן בשניות עד להופעת המודעה שהנגן צריך להמתין עד לסיום העיבוד של לחצן הדילוג. הושמט אם הוא לא סופק ב-VAST.
tracking_url (string) כתובת URL שצריך לבצע פינג לגבי אירוע הדילוג.

דוגמה לתגובה

{
  ...
  "ad_breaks":[
    {
      ...
      "start":0,
      "duration":10,
      "ads":[
        {
          ...
          "start":0,
          "duration":10,
          "skip_metadata":{
            "offset": 5,
            "tracking_url": "https://example_skip_url.com"
          }
        }
    }
}

אחרי שהמערכת מדלגת על המודעה, מבצעים פינג לכתובת ה-URL של אירוע הדילוג שכלולה בתגובה לשידור. היא כלולה בהודעת המשנה SkipMetadata.

דרישות לגבי לחצן דילוג

במודעות שניתן לדלג עליהן, לחצן הדילוג צריך לעמוד בדרישות העיצוב הבאות. אם לא תפעלו בהתאם לדרישות האלה, ייתכן שנטיל הגבלות על הצגת מודעות Google באתר או באפליקציה שלכם.

טיימר לספירה לאחור

לא ניתן לדלג על המודעה עד לזמן ה-skipoffset שצוין ב-VAST. במהלך התקופה הזו שלא ניתן לדלג עליה, צריך להציג למשתמש הודעה שמיידעת אותו שאפשר לדלג על המודעה תוך X שניות. ההודעה צריכה להיות מתורגמת לשפת המשתמש.

מיקום לחצן הדילוג

לשפה הנכתבת משמאל לימין, למקם את לחצן הדילוג בצד ימין למטה של נגן הווידאו. לשפה הנכתבת מימין לשמאל, יש למקם את לחצן הדילוג בפינה השמאלית התחתונה של נגן הווידאו.

גודל לחצן הדילוג

הלחצן והטקסט חייבים להיות גדולים מספיק כדי שניתן יהיה לקרוא אותם בצורה ברורה ונוחה.

טקסט וסמל

לחצן הדילוג צריך לכלול טקסט וגם איקונוגרפיה. תוכלו להשתמש בסמל דילוג על החומר הבא בתור האיקונוגרפיה שלכם.

נגישות

למשתמש צריכה להיות אפשרות לנווט ללחצן הדילוג באמצעות מקלדת או שלט רחוק. כשהספירה לאחור תסתיים, האפליקציה צריכה להתמקד בלחצן הדילוג.

אינטרנציונליזציה

מומלץ לתרגם את הטקסט 'דילוג' לשפת המשתמש.

רצפי מודעות

אפשר להשתמש בלחצן הדילוג כדי לדלג על המודעה הנוכחית ברצף המודעות, או כדי לדלג על כל רצף המודעות.

התרגומים של 'דילוג על המודעה'

אפשר להשתמש בקובץ skipAdTranslations.json כדי לתרגם את הטקסט 'דילוג על המודעה' לפי הלוקאל של המשתמש.