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

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

כדי להתחיל לקבל התראות מוקדמות על הפסקות למודעות בשירות מלא, בהצגת מודעות ברצף או בהוספת מודעות מבוקרת בצד השרת, אפשר להיעזר במשאב AdBreaks. המשאב הזה יכול ליצור ולנהל הפסקות למודעות בכל השידורים החיים שאתם יוצרים דרך ממשק המשתמש של Google Ad Manager או דרך ה-API של SOAP של Google Ad Manager‏ LiveStreamEventService.

בדף הזה נסביר איך לתזמן הפסקה למודעה כהודעה מוקדמת על הפסקה למודעה.

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

כדי ליצור או לנהל את ההפסקות למודעות, צריך מפתח נכס שנוצר על ידי מערכת השידור החי או מפתח נכס מותאם אישית. המפתחות האלה מופיעים גם בדף הפרטים של השידור החי. במאמר הגדרת שידור חי ל-DAI מוסבר איך להגדיר שידור חי ל-DAI באמצעות ממשק המשתמש של Google Ad Manager.

תזמון הפסקה למודעה

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

כדי לאפשר ל-Google DAI להתחיל לקבל החלטות לגבי מודעות באופן מיידי, אפשר להשמיט את שעת ההתחלה הצפויה של ההפסקה למודעה בקריאה ל-Create.

בדוגמה הבאה מתוזמן הפסקה למודעה באירוע בשידור חי מסוג Linear, שעת ההתחלה היא 16:00 לפי שעון UTC (זמן אוניברסלי מתואם) ב-6 במרץ 2025:

cURL 

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

Node.js 

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

אם הפעולה בוצעה ללא שגיאות, תופיע תגובת ה-JSON הבאה:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

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

בדוגמה הבאה מפורטות כל ההפסקות למודעות באירוע בשידור חי:

cURL 

curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

Node.js 

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

אם הפעולה בוצעה ללא שגיאות, תופיע תגובת ה-JSON הבאה:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

אם רוצים לקבוע מועד מוקדם יותר להפסקה הנוכחית למודעה, משתמשים ב-method‏ Patch כדי לשנות את שעת ההתחלה הצפויה. כדי לבטל את ההפסקה הנוכחית למודעה, צריך להשתמש בשיטה Delete לפני שהמצב שלה הוא COMPLETED.

כדי ליצור הפסקה נוספת למודעה, צריך להמתין עד שהסטטוס של ההפסקה הנוכחית למודעה יהיה COMPLETED.