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

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

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

لتجاوز مَعلمات علامة الإعلان في بث Google DAI، اضبط الحقل breakParams.adTagParams لفاصل الإعلانات. لمزيد من المعلومات، اطّلِع على معلَمات استهداف مصادر العرض في البث وجميع مَعلمات علامات إعلانات VAST.

يعرض المثال التالي علامة إعلان لبرنامج بث مباشر من "إعلانات البث المباشر" تحتوي على مَعلمة طلب البحث 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". لمزيد من المعلومات، يُرجى الاطّلاع على معرِّف شبكة "إدارة الإعلانات".
‫ASSET_KEY: مفتاح أصل حدث البث المباشر لمزيد من المعلومات، يُرجى الاطّلاع على العثور على عنوان URL لمحتوى مباشر مُجدوَل ومفتاح مادة العرض.
OAUTH_TOKEN: رمز الدخول. لمزيد من المعلومات، يُرجى الاطّلاع على المصادقة باستخدام OAuth2.

توسيع علامة الإعلان باستخدام وحدات ماكرو 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&…