از پارامترهای وقفه تبلیغات استفاده کنید

رابط برنامه‌نویسی کاربردی Ad Break به شما امکان می‌دهد پارامترهای برچسب تبلیغ را با استفاده از پارامترهای ad break تنظیم کنید، که دقت هدف‌گیری تبلیغ و ادغام با سرورهای تبلیغ را افزایش می‌دهد.

پارامترهای برچسب تبلیغ را نادیده بگیرید

برای لغو پارامترهای برچسب تبلیغ جریان 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

گوگل 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 ، شناسه‌ی تبلیغ خود را وارد کنید.

گوگل دایال تگ تبلیغ را با ماکرو به صورت زیر حل می‌کند:

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%%&…

مثال زیر از 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
          …
        }
      }
    ]
  }
}

گوگل دایال تگ تبلیغاتی را با ماکروی SCTE-35 به صورت زیر حل می‌کند:

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