استفاده از پارامترهای وقفه آگهی

«میانای برنامه‌سازی کاربردی وقفه آگهی» به شما امکان می‌دهد پارامترهای برچسب آگهی را بااستفاده از پارامترهای وقفه آگهی تنظیم کنید، که دقت هدف‌یابی آگهی و یکپارچه‌سازی با سرورهای آگهی را بهبود می‌بخشد.

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

برای ملغی کردن پارامترهای برچسب آگهی جاری‌سازی 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%%&...

مثال زیر از 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&...