استخدام مَعلمات فواصل الإعلانات

تتيح لك واجهة برمجة التطبيقات "فواصل الإعلانات" ضبط مَعلمات علامات الإعلانات باستخدام مَعلمات فواصل الإعلانات، ما يعزّز دقّة استهداف الإعلانات وتكاملها مع خوادم الإعلانات.

إلغاء مَعلمات العلامات الإعلانية

لتجاوز مَعلمات علامة الإعلان في بث 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_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

عند إعداد حدث البث المباشر باستخدام ميزة "إدراج إعلان ديناميكي" من Google، يمكنك وضع وحدات ماكرو SCTE-35 في علامة الإعلان الرئيسية.

عند بدء حدث البث المباشر، يمكنك إدراج بيانات SCTE-35 في بيان المحتوى أو استدعاء واجهة برمجة التطبيقات "فواصل إعلانية في البث المباشر" مع تضمين بيانات SCTE-35 في المَعلمة scte35CueOut. تستخدم خدمة "إدراج إعلان ديناميكي" من Google البيانات التي تم فك ترميزها لتعبئة وحدات ماكرو 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&...