שימוש בפרמטרים של הפסקות למודעה

‫Ad Break API מאפשר להגדיר את הפרמטרים של תג המודעה באמצעות פרמטרים של הפסקה למודעה, מה שמשפר את הדיוק של טירגוט המודעות והשילוב עם שרתי מודעות.

שינוי פרמטרים של תג מודעה

כדי לבטל את הפרמטרים של תג המודעה בסטרימינג של Google DAI, צריך להגדיר את השדה breakParams.adTagParams של ההפסקה למודעה. מידע נוסף זמין במאמרים בנושא העברת פרמטרים לטירגוט של מלאי שטחי פרסום לסטרימינג וכל הפרמטרים של תגי מודעות VAST.

בדוגמה הבאה מוצג תג מודעה של שידור DAI שמכיל את פרמטר השאילתה mridx (מספר המודעה באמצע סרטון):

https://pubads.g.doubleclick.net/gampad/live/ads?mridx=3&…

בדוגמה הבאה של בקשה נוצרת הפסקה למודעה שמבטלת את ערך הטירגוט mridx:

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate",
    "breakParams": {
      "adTagParams": [{"key": "mridx", "value": "7"}]
    }
  }'

מחליפים את מה שכתוב בשדות הבאים:

NETWORK_CODE: קוד הרשת שלכם ב-Google Ad Manager. מידע נוסף זמין במאמר בנושא הקוד של הרשת ב-Ad Manager.
‫ASSET_KEY: מפתח הנכס של אירוע השידור החי. למידע נוסף, ראו איתור כתובת URL של שידור לינארי במועד שנקבע מראש ומפתח נכס.
‫OAUTH_TOKEN: אסימון הגישה. למידע נוסף, ראו אימות באמצעות OAuth2.

הרחבת תג מודעה באמצעות פקודות מאקרו של DAI

‫Google DAI תומכת בפקודות מאקרו של תגי מודעות בפורמט %%DAI_PATTERN:MACRO_NAME%%. שם המאקרו צריך להיות בפורמט UPPER_CASE, והוא יכול להכיל רק אותיות רישיות, מספרים וקווים תחתונים.

אפשר להוסיף את פקודות המאקרו האלה לתג המודעה של הזרמת DAI ב-Google או לבקשת הזרמת ה-DAI כדי להגדיר את פקודות המאקרו עם הערכים בשדה breakParams.macros.

בדוגמה הבאה מוצג תג מודעה של סטרימינג ב-Google DAI שמכיל מאקרו BREAK_TYPE:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%DAI_PATTERN:BREAK_TYPE%%&…

הבקשה הבאה מעדכנת הפסקה לפרסומות ומגדירה את ערך פקודת המאקרו BREAK_TYPE:

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{
  "name": "networks/…/assets/…/adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:10:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
  "breakParams": {
    "macros": [{"key": "BREAK_TYPE", "value": "national"}]
  }
}'

מחליפים את AD_BREAK_ID במזהה של הפסקה למודעה.

מערכת Google DAI פותרת את תג המודעה עם פקודת המאקרו באופן הבא:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…

הרחבת תג המודעה באמצעות פקודות מאקרו של SCTE-35

כשמגדירים אירוע שידור חי של DAI ב-Google, אפשר להציב פקודות מאקרו של SCTE-35 בתג המודעות הראשי.

כשאירוע השידור החי מתחיל, אפשר להוסיף נתוני SCTE-35 למניפסט התוכן או לקרוא ל-API של הפסקות הפרסום ב-DAI עם נתוני SCTE-35 שכלולים בפרמטר scte35CueOut. מערכת Google DAI משתמשת בנתונים המפוענחים כדי לאכלס את פקודות המאקרו SCTE-35 בתג המודעה.

בדוגמה הבאה נעשה שימוש במאקרו %%TIME_SIGNAL_UPID_RAW%%:

‫

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%TIME_SIGNAL_UPID_RAW%%&…

בדוגמה הבאה מוצג שימוש ב-JSON כדי להמחיש נתוני אותות מתוזמנים של SCTE-35:

{
  "splice_info_section": {
    …
    "splice_command": {
      "command_name": "time_signal",
      "splice_time": {
        "time_specified_flag": 1,
        "pts_time": "123456789"
      }
    },
    "splice_descriptors": [
      {
        …
        "segmentation_upid": {
          "raw_hex": "0x6E6174696F6E616C", // UTF8 value: national
          …
        }
      }
    ]
  }
}

מערכת Google DAI פותרת את תג המודעה באמצעות פקודת המאקרו SCTE-35 באופן הבא:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…