במדריך הזה נסביר איך להשתמש ב-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 |
רשימה של הפסקות למודעות.
|
דוגמה לתגובה
{
...
"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
כדי לתרגם את הטקסט 'דילוג על המודעה' לפי הלוקאל של המשתמש.