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

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

सेवा: dai.google.com

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

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

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

लाइव स्ट्रीम सेशन दिखाने वाले डीएआई डीएआई पॉड को रजिस्टर करता है.

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

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) की मदद से पुष्टि करना वैकल्पिक एचएमएससी पर आधारित टोकन का इस्तेमाल करके पुष्टि करें.

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

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

Open Measurement

DAI API में, Verifications फ़ील्ड में Open Measurement की पुष्टि से जुड़ी जानकारी होती है. इस फ़ील्ड में एक या उससे ज़्यादा 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}

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

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

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}

विज्ञापन के लिए मौजूदा ब्रेक के लिए स्ट्रिंग आइडेंटिफ़ायर.

profile_name string

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

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

मौजूदा विज्ञापन पॉड के लिए, हस्ताक्षर किया गया और यूआरएल में बदला गया एचएमएसी टोकन .

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/{pod_id}.m3u8;

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

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

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

पाथ पैरामीटर

पैरामीटर
network_code string

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

custom_asset_key string

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

pod_id integer

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

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

पैरामीटर
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...

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

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

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

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

तरीके
GET GET /linear/pods/v1/dash/network/{network_code}/custom_asset/{custom_asset}/stream/{stream_id}/pod/{pod_id}/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_id integer

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

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

पैरामीटर
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...

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

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

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

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

Google Ad Manager से डैश पीरियड के टेंप्लेट का अनुरोध करता है. इस टेंप्लेट में ऐसे मैक्रो शामिल हैं जिन्हें आपको अपने स्ट्रीम पैरामीटर से पॉप्युलेट करना होगा. इन मैक्रो के भर जाने के बाद, टेंप्लेट आपके विज्ञापन के लिए ब्रेक की अवधि बन जाता है और इसे आपके 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 एंडपॉइंट पर किए गए अनुरोध के सही होने पर दिखती है.

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

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

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

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

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

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

पॉड मेनिफ़ेस्ट यूआरएल टेंप्लेट का इस्तेमाल, स्ट्रीम के पॉड मेनिफ़ेस्ट को वापस पाने के लिए यूआरएल जनरेट करने के लिए किया जाता है. यह यूआरएल, एचएलएस में मल्टीवैरिएंट प्लेलिस्ट या DASH में एमपीडी के यूआरएल से मेल खाता है. डाइनैमिक ऐड इंसर्शन टाइप 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 पॉड स्टिचिंग के लिए वीटीपी में लौटाए गए JSON पेलोड को दिखाता है.
JSON के काेड में दिखाना
{
  "dash_period_template": string,
  "segment_duration_ms": int64,
}
फ़ील्ड
dash_period_template string

DashPeriodTemplate एक एक्सएमएल टेंप्लेट है, जिसमें स्टिच करने से पहले सही डेटा भरा जाता है.
segment_duration_ms int64

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

आइकॉन

आइकॉन में, 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

रैपर विज्ञापन के लिए डील का वैकल्पिक आईडी.

पुष्टि करने का तरीका

पुष्टि करने की प्रोसेस में, Open Measurement की जानकारी शामिल होती है. इससे तीसरे पक्ष के विज्ञापन दिखने की जानकारी और पुष्टि करने की प्रोसेस को मेज़र करने में मदद मिलती है. फ़िलहाल, सिर्फ़ 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

अगर यह स्टैटिक टाइप का साथी है, तो VAST में <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

VAST में <AdParameters> नोड की वैल्यू.