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

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

सेवा: dai.google.com

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

तरीका: stream

तरीके
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 ऑथेंटिकेशन वैकल्पिक 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 ज़रूरी है2 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;

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

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

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 में, एन्कोड किया गया एचएमएसी टोकन होता है. इसमें यह डेटा शामिल होता है:

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

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

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

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

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

तरीके
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 प्लेलिस्ट होती है.

तरीका: डैश पॉड की अवधि का टेंप्लेट

तरीके
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 में, एन्कोड किया गया एचएमएसी टोकन होता है. इसमें यह डेटा शामिल होता है:

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

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

अगर अनुरोध पूरा होने में तय समय से ज़्यादा समय लगता है, तो अनुरोध की स्थिति 'लंबित है' के तौर पर दिखती है.

अगर इसे शामिल किया जाता है, तो टाइम आउट की वैल्यू 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 फ़ाइलों के लिए ईएमएसजी. विज्ञापन मीडिया आइडेंटिफ़ायर हमेशा google_ स्ट्रिंग से शुरू होंगे.

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

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

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

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

GET /{metadata_url}

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

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

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

GET https://{metadata_url}

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

पैरामीटर
delta_token वैकल्पिक string

यह एक ओपेक टोकन है. यह क्लाइंट के मौजूदा सिंक्रनाइज़ेशन की स्थिति को दिखाता है. अगर टोकन दिया जाता है, तो सर्वर सिर्फ़ वह मेटाडेटा दिखाता है जो टोकन जनरेट होने के बाद बदला गया है. साथ ही, जवाब में नया next_delta_token दिखाता है. अगर इसे शामिल नहीं किया जाता है, तो सर्वर डीवीआर की पूरी विंडो के लिए पूरा मेटाडेटा दिखाता है.

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

अनुरोध पूरा होने पर, जवाब में 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)],
  "next_delta_token": string,
  "obsolete_ad_break_ids": [],
}
फ़ील्ड
tags map[string, object(TagSegment)]

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

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

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

यह एक ओपेक टोकन है. इसका इस्तेमाल क्लाइंट, अगले पोल में कर सकता है.
obsolete_ad_break_ids string

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

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

विज्ञापन ब्रेक में विज्ञापनों की संख्या.
Ad, स्ट्रीम में मौजूद किसी विज्ञापन के बारे में बताता है.
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

Optional bool indicating the current entry is slate.
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

Codecs of the representation.
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

अनुकूलन सेट का एमआईएमई टाइप.
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

An opaque string passed to bootstrap verification code.

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

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

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

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