DAI API הוא בגרסת בטא ויכול להיות שלא יהיה זמין ברשת שלכם. לקבלת מידע נוסף יש לפנות למנהל החשבון. מומלץ להשתמש ב-IMA SDK בפלטפורמות שבהן הוא זמין.

דף זה תורגם על ידי Cloud Translation API.

הפעלת מודעות שניתן לדלג עליהן בסטרימינג של VOD

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

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

אפליקציה שמטמיעה קריאות ל-API של DAI להעברות 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 או במבנה AdBreak, בהתאם לדילוג על המודעה הנוכחית או על כל ההפסקה למודעה. לוקחים את הערך start ומוסיפים את הערך duration, ואז מחפשים את הנקודה הזו בסטרימינג. הודעת המשנה SkipMetadata כוללת גם את הערך offset, שהוא הערך בשניות של הזמן שחולף עד שאפשר לדלג על המודעה. הודעת המשנה SkipMetadata תכלול רק מודעות שניתן לדלג עליהן.

ad_breaks

רשימה של הפסקות למודעות.

start (number) המיקום בסטרימינג שבו מתחיל ההפסקה, בשניות.

duration (number) משך ההפסקה למודעה, בשניות.

ads

(object(Ad)) רשימה של מודעות בסטרימינג.

start (number) המיקום בסטרימינג שבו המודעה מתחילה, בשניות.

duration (number) משך המודעה, בשניות.

skip_metadata

(object(SkipMetadata)) מטא-נתונים אופציונליים למודעות שניתן לדלג עליהן. אם הערך מוגדר, המשמעות היא שהמודעה ניתנת לדילוג, והוא כולל הוראות לטיפול בממשק המשתמש לדילוג ובאירוע המעקב.

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

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