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

‫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"}]
    }
  }'

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

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

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

אפשר להוסיף את פקודות המאקרו האלה לתג המודעה של הסטרימינג ב-Google DAI או לבקשת הסטרימינג ב-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

כשמגדירים אירוע בשידור חי ב-Google DAI, אפשר להציב פקודות מאקרו של 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%%&...

בדוגמה הבאה מוצגים נתוני אות מתוזמן של SCTE-35 בפורמט JSON:

{
  "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&...