डाइनैमिक ऐड इंसर्शन एपीआई की मदद से, डीएआई लाइव स्ट्रीम का अनुरोध किया जा सकता है और उन्हें ट्रैक किया जा सकता है.
सेवा: 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) की मदद से पुष्टि करना | वैकल्पिक | 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 अवधि टेंप्लेट का अनुरोध करता है. इस टेंप्लेट में ऐसे मैक्रो शामिल हैं जिन्हें आपको अपने स्ट्रीम पैरामीटर से पॉप्युलेट करना होगा. इन मैक्रो के भर जाने के बाद, टेंप्लेट आपके विज्ञापन के लिए ब्रेक की अवधि बन जाता है और इसे आपके 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, पॉड स्टिचिंग के लिए VTP को दिखाए गए JSON पेलोड को दिखाता है.JSON के काेड में दिखाना |
---|
{ "dash_period_template": string, "segment_duration_ms": int64, } |
फ़ील्ड | |
---|---|
dash_period_template |
string DashPeriodTemplate, उस अवधि के लिए एक्सएमएल टेंप्लेट है जिसे स्टिच करने से पहले सही डेटा से भरा जाना है. |
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) है. इसके लिए, इन वैल्यू का इस्तेमाल किया जा सकता है: एचएलएस के लिए 1,000 (मिलीसेकंड) डीएश वीडियो के लिए 90,000 (पीटीएस) डीएश ऑडियो के लिए ऑडियो सैंपल रेट. |
values |
number टाइमस्केल यूनिट में, सेगमेंट की अवधि की सूची. |
DASHRepresentation
DASHRepresentation, DASH मेनिफ़ेस्ट में रेंडर किए जाने वाले रेप्रज़ेंटेशन नोड के बारे में बताता है.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 रैपर विज्ञापन के लिए डील आईडी. हालांकि, यह ज़रूरी नहीं है. |
पुष्टि करने का तरीका
पुष्टि करने की प्रोसेस में, 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> नोड की वैल्यू. |