विज्ञापन ब्रेक के पैरामीटर इस्तेमाल करना

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

इनकी जगह ये डालें:

NETWORK_CODE: आपका Google Ad Manager नेटवर्क कोड. ज़्यादा जानकारी के लिए, Ad Manager नेटवर्क कोड लेख पढ़ें.
ASSET_KEY: आपकी लाइव स्ट्रीम इवेंट की ऐसेट कुंजी. ज़्यादा जानकारी के लिए, लाइव लीनियर स्ट्रीम का यूआरएल और ऐसेट कुंजी ढूंढना लेख पढ़ें.
OAUTH_TOKEN: आपका ऐक्सेस टोकन. ज़्यादा जानकारी के लिए, OAuth2 की मदद से पुष्टि करना लेख पढ़ें.

डीएआई मैक्रो की मदद से विज्ञापन टैग को बड़ा करना

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 डेटा डाला जा सकता है. इसके अलावा, SCTE-35 पैरामीटर में शामिल SCTE-35 डेटा के साथ DAI Ad Break API को कॉल किया जा सकता है.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&…