डाइनैमिक ऐड इंसर्शन पॉड सर्विंग वाला लाइव एपीआई

डाइनैमिक ऐड इंसर्शन एपीआई की मदद से, डीएआई लाइव स्ट्रीम का अनुरोध किया जा सकता है और उन्हें ट्रैक किया जा सकता है.

सेवा: dai.google.com

सभी यूआरआई, https://dai.google.com से जुड़े हुए हैं.

तरीका: स्ट्रीम

तरीके
stream POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

यह कुकी, लाइव स्ट्रीम सेशन के दौरान DAI पॉड को रजिस्टर करती है.

एचटीटीपी अनुरोध

POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream

पाथ पैरामीटर

पैरामीटर
network_code string

पब्लिशर का Google Ad Manager नेटवर्क कोड.

custom_asset_key string

Google Ad Manager में, इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा application/x-www-form-urlencoded टाइप का होता है. इसमें ये पैरामीटर शामिल होते हैं:

पैरामीटर
DFP टारगेटिंग पैरामीटर वैकल्पिक टारगेट करने के अतिरिक्त पैरामीटर.
स्ट्रीम पैरामीटर को बदलना वैकल्पिक स्ट्रीम बनाने के पैरामीटर की डिफ़ॉल्ट वैल्यू बदलें.
HMAC Authentication वैकल्पिक HMAC पर आधारित टोकन का इस्तेमाल करके पुष्टि करें.

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में एक नया Stream ऑब्जेक्ट शामिल होता है.

मेज़रमेंट खोलें

DAI API में, Verifications फ़ील्ड में ओपन मेज़रमेंट की पुष्टि करने से जुड़ी जानकारी होती है. इस फ़ील्ड में एक या उससे ज़्यादा Verification एलिमेंट होते हैं. इनमें क्रिएटिव के प्लेबैक की पुष्टि करने के लिए, तीसरे पक्ष के मेज़रमेंट कोड को लागू करने के लिए ज़रूरी संसाधन और मेटाडेटा की सूची होती है. सिर्फ़ JavaScriptResource का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, IAB Tech Lab और VAST 4.1 की खास जानकारी देखें.

तरीका: पॉड सेगमेंट

तरीके
pod segment GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

यह कुकी, दिए गए इवेंट आईडी के लिए DAI स्ट्रीम बनाती है.

एचटीटीपी अनुरोध

GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}

पाथ पैरामीटर

पैरामीटर
network_code string

पब्लिशर का Google Ad Manager नेटवर्क कोड.

custom_asset_key string

Google Ad Manager में, इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर.

pod_identifier

इन फ़ॉर्मैट का इस्तेमाल किया जा सकता है:

pod/{integer}

मौजूदा विज्ञापन ब्रेक का न्यूमेरिक आइडेंटिफ़ायर. विज्ञापन पॉड आईडी, हर विज्ञापन ब्रेक इवेंट के लिए बढ़ते क्रम में असाइन किए जाते हैं. इनकी शुरुआत 1 से होती है.

ad_break_id/{string}

मौजूदा विज्ञापन ब्रेक के लिए स्ट्रिंग आइडेंटिफ़ायर. उस एंडपॉइंट को दिया गया कोई भी अज्ञात विज्ञापन ब्रेक आईडी, लाइव स्ट्रीम इवेंट के लिए एक नया विज्ञापन ब्रेक बनाता है.

कस्टम विज्ञापन ब्रेक आईडी पर ये पाबंदियां लागू होती हैं:

  • इसमें 1 से 63 वर्ण होने चाहिए
  • इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर, अंक, और हाइफ़न शामिल होने चाहिए.
profile_name string

अनुरोध की गई Google Ad Manager DAI एन्कोडिंग प्रोफ़ाइल का नाम. एनकोडिंग प्रोफ़ाइल, चुने गए इवेंट के लिए कॉन्फ़िगर की गई एनकोडिंग प्रोफ़ाइलों में से एक होनी चाहिए.

segment_number integer

यह मौजूदा विज्ञापन पॉड में अनुरोध किए गए सेगमेंट का इंडेक्स होता है. इसकी शुरुआत शून्य से होती है.
segment_format string

अनुरोध किए गए सेगमेंट फ़ॉर्मैट से जुड़ा फ़ाइल एक्सटेंशन. इन एक्सटेंशन को स्वीकार किया जाता है: ts, mp4, vtt, aac, ac3 या eac3.

क्वेरी पैरामीटर

पैरामीटर
stream_id ज़रूरी है string

मौजूदा उपयोगकर्ता के सेशन के लिए स्ट्रीम आईडी. यह वैल्यू, stream एंडपॉइंट पर किए गए अनुरोध के पूरा होने पर मिलती है.
sd required1 integer

अनुरोध किए गए सेगमेंट की अवधि, मिलीसेकंड में.
so वैकल्पिक

विज्ञापन पॉड में अनुरोध किए गए सेगमेंट का ऑफ़सेट, मिलीसेकंड में. अगर आपने so पैरामीटर को शामिल नहीं किया है, तो इसकी गणना इस तरह की जाएगी: सेगमेंट की अवधि को सेगमेंट की संख्या से गुणा किया जाएगा.
pd required2 integer

विज्ञापनों के पॉड की अवधि, मिलीसेकंड में.
auth-token ज़रूरी है string

auth-token में, एन्कोड किया गया HMAC टोकन होता है. इसमें यह डेटा शामिल होता है:

  • pod_id या ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp
last वैकल्पिक boolean

इससे विज्ञापन ब्रेक का आखिरी सेगमेंट पता चलता है. अन्य सभी सेगमेंट के लिए, इस पैरामीटर को शामिल न करें.
scte35 वैकल्पिक string

इस विज्ञापन ब्रेक के लिए, Base64 में एन्कोड किया गया SCTE-35 सिग्नल.
cust_params वैकल्पिक string

की-वैल्यू पेयर का एक सेट, जिसका इस्तेमाल Ad Manager कैंपेन टारगेटिंग के लिए किया जाता है. इन जोड़ियों को, यूआरएल के लिए कोड में बदली गई क्वेरी स्ट्रिंग के तौर पर दिखाया जाना चाहिए.

उदाहरण:
पैरामीटर
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...

फ़ुटनोट

  1. sd की ज़रूरत, सेगमेंट को शुरू करने के लिए नहीं होती. ↩
  2. pd की ज़रूरत उन इवेंट के लिए नहीं होती जिनमें बिना अवधि वाले विज्ञापन ब्रेक चालू होते हैं. ↩

उदाहरण

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/ad_break_id/adbreak-2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

GET https://dai.google.com/linear/pods/v1/seg/network/sandbox_dev/custom_asset/podserving-segredirect-custom-key/pod/2/profile/8b8888cf79ad43f0800482ffc035a1ac_ts_a/1.ts?so=0&sd=10000&pd=30000&stream_id=8e19cbc6-850b-404c-99d7-860aa4a674cb:TEST

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में स्ट्रीम का ऐसा सेगमेंट होगा जिसे चलाया जा सकता है. यह सेगमेंट, अनुरोध में बताए गए फ़ॉर्मैट और पैरामीटर से मेल खाएगा.

तरीका: एचएलएस पॉड मेनिफ़ेस्ट

यह फ़ंक्शन, लाइव स्ट्रीम के ऐसे एचएलएस विज्ञापन पॉड मेनिफ़ेस्ट को वापस लाता है जिसे क्लाइंट के वीडियो प्लेयर पर लोड और चलाया जा सकता है.

तरीके
GET GET /linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset}/{pod_identifier}.m3u8;

विज्ञापन पॉड के लिए, अलग-अलग वर्शन वाली HLS प्लेलिस्ट को वापस पाने के लिए एपीआई.

एचटीटीपी अनुरोध

GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}.m3u8?stream_id={stream_id}&pd={pod_duration}

पाथ पैरामीटर

पैरामीटर
network_code string

पब्लिशर का Google Ad Manager नेटवर्क कोड.
custom_asset_key string

Google Ad Manager में इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर
pod_identifier

इन फ़ॉर्मैट का इस्तेमाल किया जा सकता है:

pod/{integer}

मौजूदा विज्ञापन ब्रेक का न्यूमेरिक आइडेंटिफ़ायर. विज्ञापन पॉड आईडी, हर विज्ञापन ब्रेक इवेंट के लिए बढ़ते क्रम में असाइन किए जाते हैं. इनकी शुरुआत 1 से होती है.

ad_break_id/{string}

मौजूदा विज्ञापन ब्रेक के लिए स्ट्रिंग आइडेंटिफ़ायर. उस एंडपॉइंट को दिया गया कोई भी अज्ञात विज्ञापन ब्रेक आईडी, लाइव स्ट्रीम इवेंट के लिए एक नया विज्ञापन ब्रेक बनाता है.

कस्टम विज्ञापन ब्रेक आईडी पर ये पाबंदियां लागू होती हैं:

  • इसमें 1 से 63 वर्ण होने चाहिए
  • इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर, अंक, और हाइफ़न शामिल होने चाहिए.

क्वेरी पैरामीटर

पैरामीटर
stream_id ज़रूरी है string

मौजूदा उपयोगकर्ता के सेशन के लिए स्ट्रीम आईडी. यह वैल्यू, stream एंडपॉइंट पर किए गए अनुरोध के पूरा होने पर मिलती है.
pd ज़रूरी है integer

विज्ञापनों के पॉड की अवधि, मिलीसेकंड में.
scte35 वैकल्पिक string

इस विज्ञापन ब्रेक के लिए, Base64 में एन्कोड किया गया SCTE-35 सिग्नल.
cust_params वैकल्पिक string

की-वैल्यू पेयर का एक सेट, जिसका इस्तेमाल Ad Manager कैंपेन टारगेटिंग के लिए किया जाता है. इन जोड़ियों को, यूआरएल के लिए कोड में बदली गई क्वेरी स्ट्रिंग के तौर पर दिखाया जाना चाहिए.

उदाहरण:
पैरामीटर
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...
auth-token ज़रूरी है string

auth-token में, एन्कोड किया गया HMAC टोकन होता है. इसमें यह डेटा शामिल होता है:

  • pod_id या ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में HLS मल्टीवेरिएंट प्लेलिस्ट होती है.

तरीका: DASH पॉड मेनिफ़ेस्ट

यह फ़ंक्शन, लाइव स्ट्रीम के MPEG-DASH विज्ञापन पॉड मेनिफ़ेस्ट को वापस पाता है. यह मेनिफ़ेस्ट, क्लाइंट वीडियो प्लेयर में लोड और चलाया जा सकता है.

तरीके
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/{pod_identifier}/manifest.mpd

विज्ञापन पॉड के लिए MPEG-DASH mpd प्लेलिस्ट पाने के लिए एपीआई.

एचटीटीपी अनुरोध

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/stream/{stream_id}/pod/{pod_id}/manifest.mpd?pd={pod_duration}

पाथ पैरामीटर

पैरामीटर
network_code string

पब्लिशर का Google Ad Manager नेटवर्क कोड.
custom_asset_key string

Google Ad Manager में इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर
stream_id string

मौजूदा उपयोगकर्ता के सेशन के लिए स्ट्रीम आईडी. यह वैल्यू, stream एंडपॉइंट पर किए गए अनुरोध के पूरा होने पर मिलती है.
pod_identifier

इन फ़ॉर्मैट का इस्तेमाल किया जा सकता है:

pod/{integer}

मौजूदा विज्ञापन ब्रेक का न्यूमेरिक आइडेंटिफ़ायर. विज्ञापन पॉड आईडी, हर विज्ञापन ब्रेक इवेंट के लिए बढ़ते क्रम में असाइन किए जाते हैं. इनकी शुरुआत 1 से होती है.

ad_break_id/{string}

मौजूदा विज्ञापन ब्रेक के लिए स्ट्रिंग आइडेंटिफ़ायर. उस एंडपॉइंट को दिया गया कोई भी अज्ञात विज्ञापन ब्रेक आईडी, लाइव स्ट्रीम इवेंट के लिए एक नया विज्ञापन ब्रेक बनाता है.

कस्टम विज्ञापन ब्रेक आईडी पर ये पाबंदियां लागू होती हैं:

  • इसमें 1 से 63 वर्ण होने चाहिए
  • इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर, अंक, और हाइफ़न शामिल होने चाहिए.

क्वेरी पैरामीटर

पैरामीटर
pd ज़रूरी है integer

विज्ञापनों के पॉड की अवधि, मिलीसेकंड में.
scte35 वैकल्पिक string

इस विज्ञापन ब्रेक के लिए, Base64 में एन्कोड किया गया SCTE-35 सिग्नल.
cust_params वैकल्पिक string

की-वैल्यू पेयर का एक सेट, जिसका इस्तेमाल Ad Manager कैंपेन टारगेटिंग के लिए किया जाता है. इन जोड़ियों को, यूआरएल के लिए कोड में बदली गई क्वेरी स्ट्रिंग के तौर पर दिखाया जाना चाहिए.

उदाहरण:
पैरामीटर
  • section = sports
  • page = golf,tennis
Request URL ...&cust_params=section%3Dsports%26page%3Dgolf%2Ctennis...
auth-token ज़रूरी है string

auth-token में, एन्कोड किया गया HMAC टोकन होता है. इसमें यह डेटा शामिल होता है:

  • pod_id या ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य भाग में MPEG-DASH mpd प्लेलिस्ट होती है.

तरीका: DASH पॉड पीरियड टेंप्लेट

तरीके
pods GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

यह कुकी, Google Ad Manager से DASH पीरियड टेंप्लेट का अनुरोध करती है. इस टेंप्लेट में ऐसे मैक्रो शामिल हैं जिनमें आपको स्ट्रीम पैरामीटर की जानकारी भरनी होगी. इन मैक्रो के भर जाने के बाद, टेंप्लेट आपके विज्ञापन ब्रेक की अवधि बन जाता है. साथ ही, इसे आपके DASH मेनिफ़ेस्ट में स्टिच किया जा सकता है.

एचटीटीपी अनुरोध

GET https://dai.google.com/linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset_key}/pods.json

पाथ पैरामीटर

पैरामीटर
network_code string

पब्लिशर का Google Ad Manager नेटवर्क कोड.

custom_asset_key string

Google Ad Manager में, इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर.

क्वेरी पैरामीटर

पैरामीटर
stream_id ज़रूरी है string

मौजूदा उपयोगकर्ता के सेशन के लिए स्ट्रीम आईडी. यह वैल्यू, stream एंडपॉइंट पर किए गए अनुरोध के पूरा होने पर मिलती है.
tv वैकल्पिक integer

टेंप्लेट का वर्शन. यह डिफ़ॉल्ट रूप से 0 पर सेट होता है. यह कुकी, पॉड टेंप्लेट का वह वर्शन तय करती है जिसे वापस लाना है.

  • 0: पॉड सीक्वेंस आइडेंटिफ़ायर का इस्तेमाल करने वाले टेंप्लेट का अनुरोध करता है.
  • 1: यह एक ऐसा टेंप्लेट अनुरोध करता है जो पॉड सीक्वेंस और विज्ञापन ब्रेक आइडेंटिफ़ायर, दोनों के साथ काम करता है.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, तो जवाब के मुख्य हिस्से में नया PodTemplateResponse ऑब्जेक्ट शामिल होता है.

तरीका: विज्ञापन पॉड के समय का मेटाडेटा

तरीके
ad pod timing metadata GET /linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

यह विज्ञापन पॉड के समय का मेटाडेटा वापस पाता है.

एचटीटीपी अनुरोध

GET https://dai.google.com/linear/pods/v1/adv/network/{network_code}/custom_asset/{custom_asset_key}/pod.json

पाथ पैरामीटर

पैरामीटर
network_code string

पब्लिशर का Google Ad Manager नेटवर्क कोड.

custom_asset_key string

Google Ad Manager में, इस लाइव स्ट्रीम से जुड़ा कस्टम आइडेंटिफ़ायर.

क्वेरी पैरामीटर

पैरामीटर
stream_id ज़रूरी है string

क्लाइंट के वीडियो प्लेयर ऐप्लिकेशन से मिला Ad Manager स्ट्रीम आईडी.
ad_break_id ज़रूरी है string

विज्ञापन के अगले ब्रेक का आईडी.

विज्ञापन ब्रेक के आईडी, स्टिचिंग सर्वर या वीटीपी से मिलते हैं. ये आईडी, विज्ञापन ब्रेक की शुरुआती सूचनाओं, विज्ञापन पॉड के समय के मेटाडेटा के अनुरोधों, और एक ही विज्ञापन ब्रेक के लिए सेगमेंट रीडायरेक्ट के अनुरोधों से मेल खाने चाहिए.

कस्टम विज्ञापन ब्रेक आईडी पर ये पाबंदियां लागू होती हैं:

  • इसमें 1 से 63 वर्ण होने चाहिए
  • इसमें सिर्फ़ अंग्रेज़ी के छोटे अक्षर, अंक, और हाइफ़न शामिल होने चाहिए.
  • विज्ञापन ब्रेक आईडी preroll को प्रीरोल विज्ञापन पॉड को वापस पाने के लिए रिज़र्व किया गया है. इसका इस्तेमाल किसी अन्य विज्ञापन पॉड की पहचान करने के लिए नहीं किया जा सकता.
auth-token ज़रूरी है string

auth-token में, एन्कोड किया गया HMAC टोकन होता है. इसमें यह डेटा शामिल होता है:

  • ad_break_id
  • network_code
  • custom_asset_key
  • cust_params
  • pd
  • scte35
  • exp
timeout वैकल्पिक integer

यह मिलीसेकंड में वह समय होता है जब डीएआई, विज्ञापन से जुड़े फ़ैसले लेने के लिए इस अनुरोध को ब्लॉक कर सकता है. इस पैरामीटर का इस्तेमाल उन अनुरोधों पर करें जिनमें पहले अनुरोध पर ही विज्ञापन दिखाने होते हैं. जैसे, प्री-रोल विज्ञापन ब्रेक.

अगर टाइम आउट की अवधि खत्म हो जाती है, तो अनुरोध की स्थिति 'लंबित है' के तौर पर दिखती है.

अगर इसे शामिल किया जाता है, तो टाइम आउट की वैल्यू 1,000 से 15,000 मिलीसेकंड के बीच होनी चाहिए. अगर इसे शामिल नहीं किया जाता है, तो विज्ञापन के फ़ैसले का इंतज़ार करने के लिए जवाबों में देरी नहीं होती.
final वैकल्पिक boolean

इसे true पर सेट करें, ताकि डीएआई को यह पता चल सके कि वीटीपी, इस विज्ञापन पॉड के लिए आखिरी अनुरोध कर रहा है. अगर विज्ञापन से जुड़ा फ़ैसला, तय समयसीमा के अंदर उपलब्ध नहीं होता है, तो DAI इस अनुरोध के लिए स्लेट को हमेशा के लिए दिखाएगा.

यह डिफ़ॉल्ट रूप से false पर सेट होता है.

विज्ञापन के फ़ैसले लेने से जुड़े पैरामीटर
pd वैकल्पिक integer

विज्ञापन ब्रेक की अवधि (मिलीसेकंड में). इसे विज्ञापन पॉड की अवधि भी कहा जाता है.

अगर EABN का इस्तेमाल किया जाता है, तो pd वैल्यू, विज्ञापन ब्रेक की सूचना में दी गई अवधि से मेल खानी चाहिए. अगर अवधि मेल नहीं खाती हैं, तो EABN वैल्यू को प्राथमिकता दी जाएगी.

cust_params वैकल्पिक string

विज्ञापन ब्रेक को टारगेट करने के लिए कस्टम पैरामीटर. इनके बारे में Ad Manager सहायता केंद्र में बताया गया है.
scte35 वैकल्पिक string

Base64 में एन्कोड किया गया SCTE-35 सिग्नल.

अगर सिग्नल अमान्य है, तो रिस्पॉन्स के X-Ad-Manager-Dai-Warning एचटीटीपी हेडर में एक मैसेज भेजा जाएगा. साथ ही, अमान्य scte35 वैल्यू के बिना अनुरोध भेजा जाएगा.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, तो जवाब के मुख्य हिस्से में नया AdPodTimingMetadataResponse ऑब्जेक्ट शामिल होता है.

तरीका: मीडिया की पुष्टि करना

वीडियो चलाने के दौरान विज्ञापन मीडिया आइडेंटिफ़ायर मिलने के बाद, तुरंत ऊपर दिए गए stream एंडपॉइंट से मिले media_verification_url का इस्तेमाल करके अनुरोध करें. ये अनुरोध, सर्वर-साइड-बीकनिंग स्ट्रीम के लिए ज़रूरी नहीं हैं. इनमें सर्वर, मीडिया की पुष्टि शुरू करता है.

media verification एंडपॉइंट के लिए किए गए अनुरोध, आइडेमपोटेंट होते हैं.

तरीके
media verification GET /{media_verification_url}/{ad_media_id}

यह कुकी, मीडिया की पुष्टि करने वाले इवेंट के बारे में एपीआई को सूचना देती है.

एचटीटीपी अनुरोध

GET https://{media-verification-url}/{ad-media-id}

जवाब का मुख्य भाग

media verification ये जवाब देता है:

  • HTTP/1.1 204 No Content अगर मीडिया की पुष्टि हो जाती है और सभी पिंग भेज दिए जाते हैं.
  • HTTP/1.1 404 Not Found अगर यूआरएल का फ़ॉर्मैट गलत है या उसकी समयसीमा खत्म हो गई है, तो अनुरोध मीडिया की पुष्टि नहीं कर सकता.
  • HTTP/1.1 404 Not Found अगर इस आईडी के लिए, पुष्टि करने का पिछला अनुरोध स्वीकार कर लिया गया हो.
  • HTTP/1.1 409 Conflict अगर इस समय कोई दूसरा अनुरोध पहले से ही पिंग भेज रहा है.

विज्ञापन मीडिया आईडी

विज्ञापन मीडिया आइडेंटिफ़ायर को अलग मेटाडेटा ट्रैक में कोड किया जाएगा. जैसे, एचएलएस ट्रांसपोर्ट स्ट्रीम के लिए टाइम किया गया मेटाडेटा या mp4 फ़ाइलों के लिए emsg. विज्ञापन मीडिया आइडेंटिफ़ायर हमेशा google_ स्ट्रिंग से शुरू होंगे.

विज्ञापन की पुष्टि करने का हर अनुरोध करने से पहले, मेटाडेटा एंट्री के पूरे टेक्स्ट कॉन्टेंट को विज्ञापन की पुष्टि करने वाले यूआरएल में जोड़ना चाहिए.

तरीका: मेटाडेटा

metadata_url पर मौजूद मेटाडेटा एंडपॉइंट, विज्ञापन यूज़र इंटरफ़ेस (यूआई) बनाने के लिए इस्तेमाल की गई जानकारी दिखाता है. मेटाडेटा एंडपॉइंट, सर्वर-साइड-बीकनिंग स्ट्रीम के लिए उपलब्ध नहीं है. इसमें विज्ञापन मीडिया की पुष्टि शुरू करने की ज़िम्मेदारी सर्वर की होती है.

तरीके
metadata GET /{metadata_url}/{ad-media-id}

GET /{metadata_url}

यह कुकी, विज्ञापन के मेटाडेटा की जानकारी वापस लाती है.

एचटीटीपी अनुरोध

GET https://{metadata_url}/{ad-media-id}

GET https://{metadata_url}

जवाब का मुख्य भाग

अगर अनुरोध पूरा हो जाता है, तो जवाब में PodMetadata का एक इंस्टेंस दिखता है.

मेटाडेटा पार्स करना

मेटाडेटा में तीन अलग-अलग सेक्शन होते हैं: tags, ads, और विज्ञापन breaks. डेटा में एंट्री करने का पॉइंट, tags सेक्शन है. इसके बाद, टैग की जांच करें और पहली ऐसी एंट्री ढूंढें जिसका नाम, वीडियो स्ट्रीम में मौजूद विज्ञापन मीडिया आईडी का प्रीफ़िक्स हो. उदाहरण के लिए, आपके पास ऐसा विज्ञापन मीडिया आईडी हो सकता है:

google_1234567890

इसके बाद, आपको google_12345 नाम का टैग ऑब्जेक्ट मिलता है. इस मामले में, यह आपके विज्ञापन मीडिया आईडी से मेल खाता है. सही विज्ञापन मीडिया प्रीफ़िक्स ऑब्जेक्ट मिलने के बाद, विज्ञापन आईडी, विज्ञापन ब्रेक आईडी, और इवेंट टाइप देखा जा सकता है. इसके बाद, विज्ञापन आईडी का इस्तेमाल ads ऑब्जेक्ट को इंडेक्स करने के लिए किया जाता है. साथ ही, विज्ञापन ब्रेक आईडी का इस्तेमाल breaks ऑब्जेक्ट को इंडेक्स करने के लिए किया जाता है.

एपीआई ऑब्जेक्ट

स्ट्रीम

स्ट्रीम का इस्तेमाल, JSON फ़ॉर्मैट में नई बनाई गई स्ट्रीम के लिए संसाधनों की सूची को रेंडर करने के लिए किया जाता है.
JSON के काेड में दिखाना
{
  "stream_id": string,
  "media_verification_url": string,
  "metadata_url": string,
  "session_update_url": string,
  "heartbeat_url": string,
  "polling_frequency": number,
  "pod_manifest_url": string,
  "manifest_format": string,
}
फ़ील्ड
stream_id string

यह GAM स्ट्रीम आइडेंटिफ़ायर है.
media_verification_url string

मीडिया की पुष्टि करने वाले यूआरएल का इस्तेमाल, वीडियो चलाने से जुड़े इवेंट को ट्रैक करने के लिए बेस एंडपॉइंट के तौर पर किया जाता है.
metadata_url string

मेटाडेटा यूआरएल का इस्तेमाल, स्ट्रीम में दिखने वाले विज्ञापन के आने वाले इवेंट के बारे में समय-समय पर जानकारी पाने के लिए किया जाता है.
session_update_url string

इस सेशन के अपडेट यूआरएल का इस्तेमाल, इस स्ट्रीम के टारगेटिंग पैरामीटर को अपडेट करने के लिए किया जाता है. टारगेटिंग पैरामीटर की ओरिजनल वैल्यू, स्ट्रीम बनाने के शुरुआती अनुरोध के दौरान कैप्चर की जाती हैं.
heartbeat_url string

हार्टबीट यूआरएल का इस्तेमाल, सर्वर साइड बीकनिंग स्ट्रीम को चालू रखने के लिए किया जाता है. इसे हर {PollingFrequency} सेकंड में पिंग करना ज़रूरी है. सर्वर साइड बीकनिंग स्ट्रीम के लिए भरा गया.
polling_frequency number

metadata_url या heartbeat_url के लिए अनुरोध करते समय, पोलिंग फ़्रीक्वेंसी (सेकंड में).
pod_manifest_url string

पॉड मेनिफ़ेस्ट यूआरएल टेंप्लेट का इस्तेमाल, स्ट्रीम के पॉड मेनिफ़ेस्ट को वापस पाने के लिए यूआरएल जनरेट करने के लिए किया जाता है. यह यूआरएल, एचएलएस में मल्टीवैरिएंट प्लेलिस्ट के यूआरएल या डैश में एमपीडी से मेल खाता है. यह फ़ील्ड, POD_SERVING_MANIFEST टाइप के डाइनैमिक विज्ञापन शामिल करने की सुविधा वाले लाइव स्ट्रीम इवेंट के लिए भरा जाता है. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType
manifest_format string

मेनिफ़ेस्ट फ़ॉर्मैट, pod_manifest_url से वापस पाया गया मेनिफ़ेस्ट फ़ॉर्मैट है. यह डैश या एचएलएस में से कोई एक हो सकता है.

PodMetadata

PodMetadata में विज्ञापनों, विज्ञापन ब्रेक, और मीडिया आईडी टैग के मेटाडेटा की जानकारी होती है.
JSON के काेड में दिखाना
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
}
फ़ील्ड
tags map[string, object(TagSegment)]

टैग प्रीफ़िक्स के हिसाब से इंडेक्स किए गए टैग सेगमेंट का मैप.
ads map[string, object(Ad)]

विज्ञापन आईडी के हिसाब से इंडेक्स किए गए विज्ञापनों का मैप.
ad_breaks map[string, object(AdBreak)]

विज्ञापन के लिए ब्रेक का मैप, जिसे विज्ञापन के लिए ब्रेक के आईडी के हिसाब से इंडेक्स किया गया है.

TagSegment

TagSegment में विज्ञापन, उसके विज्ञापन ब्रेक, और इवेंट टाइप का रेफ़रंस होता है. type="progress" वाले TagSegment को विज्ञापन मीडिया की पुष्टि करने वाले एंडपॉइंट पर पिंग नहीं किया जाना चाहिए.
JSON के काेड में दिखाना
{
  "ad": string,
  "ad_break_id": string,
  "type": string,
}
फ़ील्ड
ad string

इस टैग के विज्ञापन का आईडी.
ad_break_id string

इस टैग के विज्ञापन ब्रेक का आईडी.
type string

यह टैग के इवेंट का टाइप है.

AdBreak

AdBreak, स्ट्रीम में मौजूद एक विज्ञापन ब्रेक के बारे में बताता है. इसमें अवधि, टाइप (मिड/प्री/पोस्ट), और विज्ञापनों की संख्या शामिल होती है.
JSON के काेड में दिखाना
{
  "type": string,
  "duration": number,
  "expected_duration": number,
  "ads": number,
}
फ़ील्ड
type string

विज्ञापन ब्रेक के मान्य टाइप ये हैं: प्री, मिड, और पोस्ट.
duration number

इस विज्ञापन ब्रेक की कुल अवधि, सेकंड में.
expected_duration number

विज्ञापन ब्रेक की अनुमानित अवधि (सेकंड में). इसमें सभी विज्ञापन और कोई भी स्लेट शामिल है.
ads number

विज्ञापन के लिए ब्रेक में विज्ञापनों की संख्या.
विज्ञापन, स्ट्रीम में मौजूद किसी विज्ञापन के बारे में बताता है.
JSON के काेड में दिखाना
{
  "ad_break_id": string,
  "position": number,
  "duration": number,
  "title": string,
  "description": string,
  "advertiser": string,
  "ad_system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
  "clickthrough_url": string,
  "click_tracking_urls": [],
  "verifications": [object(Verification)],
  "slate": boolean,
  "icons": [object(Icon)],
  "wrappers": [object(Wrapper)],
  "universal_ad_id": object(UniversalAdID),
  "extensions": [],
  "companions": [object(Companion)],
  "interactive_file": object(InteractiveFile),
}
फ़ील्ड
ad_break_id string

इस विज्ञापन के विज्ञापन ब्रेक का आईडी.
position number

विज्ञापन ब्रेक में इस विज्ञापन की पोज़िशन. इसकी शुरुआत 1 से होती है.
duration number

विज्ञापन की अवधि (सेकंड में).
title string

विज्ञापन का वैकल्पिक टाइटल.
description string

विज्ञापन की जानकारी देना ज़रूरी नहीं है.
advertiser string

विज्ञापन देने वाले का वैकल्पिक आइडेंटिफ़ायर.
ad_system string

विज्ञापन सिस्टम की जानकारी देना ज़रूरी नहीं है.
ad_id string

विज्ञापन आईडी देना ज़रूरी नहीं है.
creative_id string

क्रिएटिव आईडी देना ज़रूरी नहीं है.
creative_ad_id string

क्रिएटिव विज्ञापन आईडी देना ज़रूरी नहीं है.
deal_id string

डील आईडी (ज़रूरी नहीं).
clickthrough_url string

क्लिकथ्रू यूआरएल (ज़रूरी नहीं).
click_tracking_urls string

क्लिक ट्रैकिंग के यूआरएल (ज़रूरी नहीं).
verifications [object(Verification)]

ओपन मेज़रमेंट की पुष्टि करने वाली ऐसी एंट्री जो ज़रूरी नहीं हैं. इनमें ऐसे संसाधन और मेटाडेटा शामिल होते हैं जिनकी ज़रूरत तीसरे पक्ष के मेज़रमेंट कोड को लागू करने के लिए होती है. इससे क्रिएटिव के प्लेबैक की पुष्टि की जा सकती है.
slate boolean

वैकल्पिक बूलियन से पता चलता है कि मौजूदा एंट्री स्लेट है.
icons [object(Icon)]

आइकॉन की सूची. अगर यह खाली है, तो इसे शामिल नहीं किया जाता.
wrappers [object(Wrapper)]

अगर रैपर की सूची खाली है, तो इसे शामिल नहीं किया जाता.
universal_ad_id object(UniversalAdID)

यूनिवर्सल विज्ञापन आईडी देना ज़रूरी नहीं है.
extensions string

VAST में मौजूद सभी <Extension> नोड की वैकल्पिक सूची.
companions [object(Companion)]

इस विज्ञापन के साथ दिखाए जा सकने वाले सहयोगी विज्ञापन (ज़रूरी नहीं).
interactive_file object(InteractiveFile)

इंटरैक्टिव क्रिएटिव (SIMID) का इस्तेमाल करना ज़रूरी नहीं है. इसे विज्ञापन दिखाने के दौरान दिखाया जाना चाहिए.

PodTemplateResponse

PodTemplateResponse, पॉड स्टिचिंग के लिए VTP को भेजे गए JSON पेलोड को दिखाता है.
JSON के काेड में दिखाना
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
फ़ील्ड
dash_period_template string

DashPeriodTemplate, अवधि के लिए xml टेंप्लेट है. स्टिचिंग से पहले, इसमें सही डेटा भरा जाना चाहिए.
segment_duration_ms int64

SegmentDurationMS, अवधि के सेगमेंट की अवधि को मिलीसेकंड में दिखाता है.

AdpodTimingMetadataResponse

AdpodTimingMetadataResponse में, विज्ञापन पॉड और उसके लिए सेगमेंट यूआरएल बनाने के तरीके के बारे में जानकारी होती है.
JSON के काेड में दिखाना
{
  "status": string,
  "ads": [object(AdRendering)],
  "slate": object(SlateRendering),
  "dash_representations": map[string, object(DASHRepresentation)],
  "dash_adaptation_sets": map[string, object(DASHAdaptationSet)],
}
फ़ील्ड
status string

विज्ञापन पॉड के लिए फ़ैसले का स्टेटस.
ads [object(AdRendering)]

विज्ञापन ऑब्जेक्ट का कलेक्शन. इसमें विज्ञापन सेगमेंट के यूआरएल को रेंडर करने का तरीका बताया गया है. इनकी इंडेक्सिंग 0 से शुरू होती है.
slate object(SlateRendering)

स्लेट, जिसमें स्लेट सेगमेंट के यूआरएल रेंडर करने का तरीका बताया गया है.
dash_representations map[string, object(DASHRepresentation)]

उस विज्ञापन पॉड के लिए DASH रिप्रेजेंटेशन की सूची, जिसे DASH मेनिफ़ेस्ट में रेंडर किया जाना है.
dash_adaptation_sets map[string, object(DASHAdaptationSet)]

उस विज्ञापन पॉड के लिए DASH अडैप्टेशन सेट की सूची, जिसे DASH मेनिफ़ेस्ट में रेंडर किया जाना है.

AdRendering

AdRendering से पता चलता है कि फ़ैसले के आधार पर विज्ञापन को कैसे रेंडर किया जाता है.
JSON के काेड में दिखाना
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
फ़ील्ड
duration_ms number

विज्ञापन की अवधि, मिलीसेकंड में (int).
variants map[string, object(VariantRendering)]

वैरिएंट ऑब्जेक्ट की डिक्शनरी (नीचे देखें). इसे यूज़र इंटरफ़ेस (यूआई) से कॉन्फ़िगर किए गए वैरिएंट/प्रोफ़ाइल आईडी के हिसाब से इंडेक्स किया जाता है.

SlateRendering

SlateRendering में, स्लेट कॉन्टेंट को रेंडर करने का तरीका बताया गया है.
JSON के काेड में दिखाना
{
  "duration_ms": number,
  "variants": map[string, object(VariantRendering)],
}
फ़ील्ड
duration_ms number

स्लेट की अवधि, मिलीसेकंड में (int).
variants map[string, object(VariantRendering)]

वैरिएंट ऑब्जेक्ट की डिक्शनरी, जिसे वैरिएंट/प्रोफ़ाइल आईडी के हिसाब से इंडेक्स किया जाता है. स्लेट की अवधि को तब तक लूप किया जाना चाहिए, जब तक स्लेट की ज़रूरी लंबाई पूरी न हो जाए. इसके लिए, हर बार स्लेट की अवधि को लूप करने के बीच में एचएलएस डिसकंटिन्यूटी डालें या MPEG-DASH के लिए नई अवधियां लूप करें.

VariantRendering

VariantRendering, विज्ञापन/स्लेट में मौजूद किसी एक वैरिएंट/प्रोफ़ाइल के बारे में बताता है.
JSON के काेड में दिखाना
{
  "segment_extension": string,
  "segment_durations": object(SegmentDurations),
}
फ़ील्ड
segment_extension string

स्ट्रिंग, इनमें से कोई एक: ts, mp4, aac, ac3, ec3, m4a, m4v. सेगमेंट के यूआरएल का फ़ाइल नाम एक्सटेंशन वाला हिस्सा.
segment_durations object(SegmentDurations)

SegmentDurations ऑब्जेक्ट. हर सेगमेंट की अवधि को सेगमेंट यूआरएल में बदला जा सकता है.

SegmentDurations

SegmentDurations, किसी तय समय इकाई में सेगमेंट के क्रम की अवधि के बारे में बताता है.
JSON के काेड में दिखाना
{
  "timescale": number,
  "values": [],
}
फ़ील्ड
timescale number

टाइमस्केल, हर सेकंड में यूनिट की संख्या होती है (int) यह इस तरह से होना चाहिए: एचएलएस के लिए 1000 (मिलीसेकंड) डैश वीडियो के लिए 90000 (पीटीएस) डैश ऑडियो के लिए ऑडियो सैंपल रेट.
values number

टाइमस्केल यूनिट में, int सेगमेंट की अवधि का कलेक्शन.

DASHRepresentation

DASHRepresentation, DASH मेनिफ़ेस्ट में रेंडर किए जाने वाले Representation नोड के बारे में बताता है.
JSON के काेड में दिखाना
{
  "codecs": string,
  "bandwidth": number,
  "width": number,
  "height": number,
  "frame_rate": string,
  "audio_sampling_rate": number,
  "audio_channel_config": object(SchemeIDURIAndValue),
}
फ़ील्ड
codecs string

रिप्रेज़ेंटेशन के कोडेक.
bandwidth number

रिप्रेज़ेंटेशन की बैंडविथ.
width number

रिप्रेज़ेंटेशन की चौड़ाई.
height number

रिप्रेज़ेंटेशन की ऊंचाई.
frame_rate string

रिप्रेज़ेंटेशन का फ़्रेम रेट.
audio_sampling_rate number

रिप्रेज़ेंटेशन का ऑडियो सैंपलिंग रेट.
audio_channel_config object(SchemeIDURIAndValue)

रिप्रेज़ेंटेशन का ऑडियो चैनल कॉन्फ़िगरेशन.

DASHAdaptationSet

DASHAdaptationSet, DASH मेनिफ़ेस्ट में रेंडर किए जाने वाले AdaptationSet नोड के बारे में बताता है.
JSON के काेड में दिखाना
{
  "content_type": string,
  "mime_type": string,
  "role": object(SchemeIDURIAndValue),
  "inband_event_stream": object(SchemeIDURIAndValue),
  "min_frame_rate": string,
  "max_frame_rate": string,
  "scan_type": string,
  "start_with_sap": string,
  "segment_alignment": boolean,
  "representations": [],
}
फ़ील्ड
content_type string

ऐडैप्टेशन सेट का कॉन्टेंट टाइप.
mime_type string

अनुकूलन सेट का MIME टाइप.
role object(SchemeIDURIAndValue)

अनुकूलन सेट की भूमिका.
inband_event_stream object(SchemeIDURIAndValue)

यह अडैप्टेशन सेट की इनबैंड इवेंट स्ट्रीम है.
min_frame_rate string

एडैप्टेशन सेट की कम से कम फ़्रेम दर.
max_frame_rate string

अनुकूलन सेट का ज़्यादा से ज़्यादा फ़्रेम रेट.
scan_type string

अडैप्टेशन सेट का स्कैन टाइप.
start_with_sap string

अडैप्टेशन सेट के एसएपी से शुरुआत करें.
segment_alignment boolean

ऐडप्टेशन सेट का सेगमेंट अलाइनमेंट.
representations string

अनुकूलन सेट के वर्शन.

SchemeIDURIAndValue

SchemeIDURIAndValue, स्कीम आईडी और उसकी वैल्यू का पेयर होता है.
JSON के काेड में दिखाना
{
  "scheme_id_uri": string,
  "value": string,
}
फ़ील्ड
scheme_id_uri string

वैल्यू का स्कीम आईडी यूआरआई.
value string

स्कीम आईडी यूआरआई की वैल्यू.

आइकॉन

इस आइकॉन में VAST आइकॉन के बारे में जानकारी होती है.
JSON के काेड में दिखाना
{
  "click_data": object(ClickData),
  "creative_type": string,
  "click_fallback_images": [object(FallbackImage)],
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "x_position": string,
  "y_position": string,
  "program": string,
  "alt_text": string,
}
फ़ील्ड
click_data object(ClickData)

creative_type string

click_fallback_images [object(FallbackImage)]

height int32

width int32

resource string

type string

x_position string

y_position string

program string

alt_text string

ClickData

ClickData में, आइकॉन पर क्लिक करने से जुड़ी जानकारी होती है.
JSON के काेड में दिखाना
{
  "url": string,
}
फ़ील्ड
url string

FallbackImage

FallbackImage में VAST फ़ॉलबैक इमेज के बारे में जानकारी होती है.
JSON के काेड में दिखाना
{
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "alt_text": string,
}
फ़ील्ड
creative_type string

height int32

width int32

resource string

alt_text string

Wrapper

रैपर में, रैपर विज्ञापन के बारे में जानकारी होती है. अगर डील आईडी मौजूद नहीं है, तो उसे शामिल नहीं किया जाता.
JSON के काेड में दिखाना
{
  "system": string,
  "ad_id": string,
  "creative_id": string,
  "creative_ad_id": string,
  "deal_id": string,
}
फ़ील्ड
system string

विज्ञापन सिस्टम आइडेंटिफ़ायर.
ad_id string

रैपर विज्ञापन के लिए इस्तेमाल किया गया विज्ञापन आईडी.
creative_id string

रैपर विज्ञापन के लिए इस्तेमाल किया गया क्रिएटिव आईडी.
creative_ad_id string

रैपर विज्ञापन के लिए इस्तेमाल किया गया क्रिएटिव विज्ञापन आईडी.
deal_id string

रैपर विज्ञापन के लिए डील आईडी. हालांकि, यह ज़रूरी नहीं है.

पुष्टि

पुष्टि करने की सुविधा में ओपन मेज़रमेंट की जानकारी शामिल होती है. इससे तीसरे पक्ष को व्यूएबिलिटी और पुष्टि करने से जुड़े मेज़रमेंट में मदद मिलती है. फ़िलहाल, सिर्फ़ JavaScript रिसॉर्स इस्तेमाल किए जा सकते हैं. https://iabtechlab.com/standards/open-measurement-sdk/ पर जाएं
JSON के काेड में दिखाना
{
  "vendor": string,
  "java_script_resources": [object(JavaScriptResource)],
  "tracking_events": [object(TrackingEvent)],
  "parameters": string,
}
फ़ील्ड
vendor string

पुष्टि करने वाली कंपनी.
java_script_resources [object(JavaScriptResource)]

पुष्टि के लिए JavaScript संसाधनों की सूची.
tracking_events [object(TrackingEvent)]

पुष्टि करने के लिए, ट्रैकिंग इवेंट की सूची.
parameters string

पुष्टि करने के लिए बूटस्ट्रैप कोड को पास की गई ओपेक स्ट्रिंग.

JavaScriptResource

JavaScriptResource में, JavaScript के ज़रिए पुष्टि करने के लिए जानकारी होती है.
JSON के काेड में दिखाना
{
  "script_url": string,
  "api_framework": string,
  "browser_optional": boolean,
}
फ़ील्ड
script_url string

JavaScript पेलोड का यूआरआई.
api_framework string

APIFramework, वीडियो फ़्रेमवर्क का नाम है. यह पुष्टि करने के लिए कोड का इस्तेमाल करता है.
browser_optional boolean

क्या इस स्क्रिप्ट को ब्राउज़र के बाहर चलाया जा सकता है.

TrackingEvent

TrackingEvent में ऐसे यूआरएल होते हैं जिन्हें कुछ स्थितियों में क्लाइंट को पिंग करना चाहिए.
JSON के काेड में दिखाना
{
  "event": string,
  "uri": string,
}
फ़ील्ड
event string

ट्रैकिंग इवेंट का टाइप.
uri string

ट्रैकिंग इवेंट, जिसे पिंग किया जाना है.

UniversalAdID

UniversalAdID का इस्तेमाल, एक यूनीक क्रिएटिव आइडेंटिफ़ायर उपलब्ध कराने के लिए किया जाता है. इसे सभी विज्ञापन सिस्टम में बनाए रखा जाता है.
JSON के काेड में दिखाना
{
  "id_value": string,
  "id_registry": string,
}
फ़ील्ड
id_value string

विज्ञापन के लिए चुने गए क्रिएटिव का यूनिवर्सल विज्ञापन आईडी.
id_registry string

यह एक स्ट्रिंग है. इसका इस्तेमाल, रजिस्ट्री वेबसाइट के उस यूआरएल की पहचान करने के लिए किया जाता है जहां चुने गए क्रिएटिव के यूनिवर्सल विज्ञापन आईडी को कैटलॉग किया गया है.

Companion

इस कुकी में सहयोगी विज्ञापनों के बारे में जानकारी होती है. ये विज्ञापन, विज्ञापन के साथ दिख सकते हैं.
JSON के काेड में दिखाना
{
  "click_data": object(ClickData),
  "creative_type": string,
  "height": int32,
  "width": int32,
  "resource": string,
  "type": string,
  "ad_slot_id": string,
  "api_framework": string,
  "tracking_events": [object(TrackingEvent)],
}
फ़ील्ड
click_data object(ClickData)

इस कंपैनियन के लिए क्लिक डेटा.
creative_type string

अगर यह स्टैटिक टाइप का कंपैनियन है, तो वीएएसटी में <StaticResource> नोड पर CreativeType एट्रिब्यूट.
height int32

इस कंपैनियन की ऊंचाई, पिक्सल में.
width int32

इस कंपैनियन की चौड़ाई, पिक्सल में.
resource string

स्टैटिक और iframe कंपैनियन के लिए, यह लोड और दिखाया जाने वाला यूआरएल होगा. एचटीएमएल कंपैनियन के लिए, यह वह एचटीएमएल स्निपेट होगा जिसे कंपैनियन के तौर पर दिखाया जाना चाहिए.
type string

यह कंपेनियन किस तरह का है. यह स्टैटिक, iframe या एचटीएमएल हो सकता है.
ad_slot_id string

इस कंपैनियन के लिए स्लॉट आईडी.
api_framework string

इस कंपैनियन के लिए एपीआई फ़्रेमवर्क.
tracking_events [object(TrackingEvent)]

इस कंपैनियन के लिए ट्रैकिंग इवेंट की सूची.

InteractiveFile

InteractiveFile में इंटरैक्टिव क्रिएटिव (यानी कि SIMID) की जानकारी होती है. इसे विज्ञापन चलाने के दौरान दिखाया जाना चाहिए.
JSON के काेड में दिखाना
{
  "resource": string,
  "type": string,
  "variable_duration": boolean,
  "ad_parameters": string,
}
फ़ील्ड
resource string

इंटरैक्टिव क्रिएटिव का यूआरएल.
type string

संसाधन के तौर पर दी गई फ़ाइल का MIME टाइप.
variable_duration boolean

इस क्रिएटिव में, अवधि बढ़ाने के लिए कहा जा सकता है या नहीं.
ad_parameters string

यह वीएएसटी में <AdParameters> नोड की वैल्यू है.