डाइनैमिक ऐड इंसर्शन एपीआई की मदद से, डीएआई लाइव स्ट्रीम का अनुरोध किया जा सकता है और उन्हें ट्रैक किया जा सकता है.
सेवा: 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}
विज्ञापन के लिए मौजूदा ब्रेक के लिए संख्या वाला आइडेंटिफ़ायर. विज्ञापन के लिए ब्रेक के हर इवेंट के लिए, विज्ञापन पॉड आईडी को ad_break_id/{string}
विज्ञापन के लिए मौजूदा ब्रेक के लिए स्ट्रिंग आइडेंटिफ़ायर. |
profile_name |
string
Google Ad Manager की उस डीआई प्रोफ़ाइल का नाम जिसके लिए अनुरोध किया गया है. कोड बदलने की प्रोफ़ाइल, चुने गए इवेंट के लिए कॉन्फ़िगर की गई कोड बदलने की प्रोफ़ाइलों में से एक होनी चाहिए. |
segment_number |
integer
विज्ञापनों के मौजूदा पॉड में, अनुरोध किए गए सेगमेंट का इंडेक्स, शून्य से शुरू होता है. |
segment_format |
string
अनुरोध किए गए सेगमेंट फ़ॉर्मैट से जुड़ा फ़ाइल एक्सटेंशन.
ये एक्सटेंशन इस्तेमाल किए जा सकते हैं: |
क्वेरी पैरामीटर
पैरामीटर | ||||||
---|---|---|---|---|---|---|
stream_id |
ज़रूरी है |
string
मौजूदा उपयोगकर्ता के सेशन का स्ट्रीम आईडी. यह वैल्यू, |
||||
sd |
required1
|
integer
अनुरोध किए गए सेगमेंट की अवधि, मिलीसेकंड में. |
||||
so |
वैकल्पिक |
विज्ञापन पॉड में, अनुरोध किए गए सेगमेंट का ऑफ़सेट, मिलीसेकंड में.
अगर |
||||
pd |
ज़रूरी है2 |
integer
विज्ञापन पॉड की अवधि, मिलीसेकंड में. |
||||
auth-token |
ज़रूरी है |
string
मौजूदा विज्ञापन पॉड के लिए, हस्ताक्षर किया गया और यूआरएल में बदला गया एचएमएसी टोकन . |
||||
last |
वैकल्पिक |
boolean
विज्ञापन के लिए ब्रेक के आखिरी सेगमेंट को दिखाता है. बाकी सभी सेगमेंट के लिए, इस पैरामीटर को शामिल न करें. |
||||
scte35 |
वैकल्पिक |
string
इस विज्ञापन के लिए, Base64 में एन्कोड किया गया SCTE-35 सिग्नल. |
||||
cust_params |
वैकल्पिक |
string
की-वैल्यू पेयर का सेट, जिसका इस्तेमाल Ad Manager कैंपेन टारगेटिंग के लिए किया जाता है. इन जोड़ों को कोड में बदले गए यूआरएल के तौर पर दिखाया जाना चाहिए. उदाहरण:
|
फ़ुटनोट
-
शुरू करने वाले सेगमेंट के लिए,
sd
की ज़रूरत नहीं होती. ↩ -
जिन इवेंट में विज्ञापन के लिए लगातार ब्रेक की सुविधा चालू है उनके लिए
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
विज्ञापन के लिए मौजूदा ब्रेक के लिए संख्या वाला आइडेंटिफ़ायर. विज्ञापन के लिए ब्रेक के हर इवेंट के लिए, विज्ञापन पॉड आईडी को |
क्वेरी पैरामीटर
पैरामीटर | ||||||
---|---|---|---|---|---|---|
stream_id |
ज़रूरी है |
string
मौजूदा उपयोगकर्ता के सेशन का स्ट्रीम आईडी. यह वैल्यू, |
||||
pd |
ज़रूरी है |
integer
विज्ञापन पॉड की अवधि, मिलीसेकंड में. |
||||
scte35 |
वैकल्पिक |
string
इस विज्ञापन के लिए, Base64 में एन्कोड किया गया SCTE-35 सिग्नल. |
||||
cust_params |
वैकल्पिक |
string
की-वैल्यू पेयर का सेट, जिसका इस्तेमाल Ad Manager कैंपेन टारगेटिंग के लिए किया जाता है. इन जोड़ों को कोड में बदले गए यूआरएल के तौर पर दिखाया जाना चाहिए. उदाहरण:
|
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, तो जवाब के मुख्य हिस्से में मल्टीवैरिएंट वाली एचएलएस प्लेलिस्ट शामिल होती है.
तरीका: 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
मौजूदा उपयोगकर्ता के सेशन का स्ट्रीम आईडी. यह वैल्यू, |
pod_id |
integer
विज्ञापन के लिए मौजूदा ब्रेक के लिए संख्या वाला आइडेंटिफ़ायर. विज्ञापन के लिए ब्रेक के हर इवेंट के लिए, विज्ञापन पॉड आईडी को |
क्वेरी पैरामीटर
पैरामीटर | ||||||
---|---|---|---|---|---|---|
pd |
ज़रूरी है |
integer
विज्ञापन पॉड की अवधि, मिलीसेकंड में. |
||||
scte35 |
वैकल्पिक |
string
इस विज्ञापन के लिए, Base64 में एन्कोड किया गया SCTE-35 सिग्नल. |
||||
cust_params |
वैकल्पिक |
string
की-वैल्यू पेयर का सेट, जिसका इस्तेमाल Ad Manager कैंपेन टारगेटिंग के लिए किया जाता है. इन जोड़ों को कोड में बदले गए यूआरएल के तौर पर दिखाया जाना चाहिए. उदाहरण:
|
जवाब का मुख्य भाग
अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में 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
मौजूदा उपयोगकर्ता के सेशन का स्ट्रीम आईडी. यह वैल्यू, |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, तो जवाब के मुख्य हिस्से में एक नया
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> नोड की वैल्यू. |