מודעות ניתנות לדילוג בסטרימינג ב-VOD

המדריך הזה מסביר איך להשתמש ב-DAI API כדי לבקש שידור VOD עם מודעות שניתן לדלג עליהן, עיבוד לחצן הדילוג בהתאם הדרישות של Google Ads, ולשלוח את אירועי המעקב המשויכים.

דרישות מוקדמות

• אפליקציה שמטמיעה קריאות ל-DAI API עבור מקורות נתונים של VOD. לצפייה מדריך לשידור VOD ב-DAI API אפשר לקבל מידע נוסף.

שליחת בקשה להצגת מודעות שניתן לדלג עליהן

כדי לבקש שידור 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) Offset (מספר) מציין את משך הזמן ב- שניות אחרי המודעה, הנגן צריך להמתין כדי לעבד את לחצן הדילוג. חסר אם הוא לא סופק ב-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 לתרגום של 'דילוג על מודעה' טקסט בהתאם ללוקאל של המשתמש.