डाइनैमिक ऐड इंसर्शन एपीआई की मदद से, डीएआई लाइव स्ट्रीम का अनुरोध किया जा सकता है और उन्हें ट्रैक किया जा सकता है.
Service: dai.google.com
सभी यूआरआई, https://dai.google.com
से जुड़े हुए हैं.
तरीका: स्ट्रीम
तरीके | |
---|---|
stream |
POST /ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream
यह कुकी, लाइव स्ट्रीम सेशन के लिए DAI DAI पॉड को रजिस्टर करती है. |
एचटीटीपी अनुरोध
POST https://dai.google.com/ssai/pods/api/v1/network/{network_code}/custom_asset/{custom_asset_key}/stream
पाथ पैरामीटर
पैरामीटर | |
---|---|
network_code |
string
पब्लिशर का Google Ad Manager नेटवर्क कोड. |
custom_asset_key |
string
Google Ad Manager में, इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर. |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा application/x-www-form-urlencoded
टाइप का होता है. इसमें ये पैरामीटर शामिल होते हैं:
पैरामीटर | ||
---|---|---|
DFP टारगेटिंग पैरामीटर | वैकल्पिक | टारगेट करने के अतिरिक्त पैरामीटर. |
स्ट्रीम पैरामीटर को बदलना | वैकल्पिक | स्ट्रीम बनाने के पैरामीटर की डिफ़ॉल्ट वैल्यू बदलें. |
HMAC Authentication | वैकल्पिक | HMAC पर आधारित टोकन का इस्तेमाल करके पुष्टि करें. |
जवाब का मुख्य भाग
अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में एक नया Stream
ऑब्जेक्ट शामिल होता है.
मेज़रमेंट खोलें
DAI API में, Verifications
फ़ील्ड में ओपन मेज़रमेंट की पुष्टि करने से जुड़ी जानकारी होती है. इस फ़ील्ड में एक या उससे ज़्यादा Verification
एलिमेंट होते हैं. इनमें क्रिएटिव के प्लेबैक की पुष्टि करने के लिए, तीसरे पक्ष के मेज़रमेंट कोड को लागू करने के लिए ज़रूरी संसाधन और मेटाडेटा की सूची होती है. सिर्फ़ JavaScriptResource
का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, कृपया IAB Tech Lab और VAST 4.1 की खास जानकारी देखें.
तरीका: पॉड सेगमेंट
तरीके | |
---|---|
pod segment |
GET /linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}
यह कुकी, दिए गए इवेंट आईडी के लिए DAI स्ट्रीम बनाती है. |
एचटीटीपी अनुरोध
GET https://dai.google.com/linear/pods/v1/seg/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}/profile/{profile_name}/{segment_number}.{segment_format}
पाथ पैरामीटर
पैरामीटर | |
---|---|
network_code |
string
पब्लिशर का Google Ad Manager नेटवर्क कोड. |
custom_asset_key |
string
Google Ad Manager में, इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर. |
pod_identifier |
इन फ़ॉर्मैट का इस्तेमाल किया जा सकता है: pod/{integer}
मौजूदा विज्ञापन ब्रेक का न्यूमेरिक आइडेंटिफ़ायर. विज्ञापन पॉड आईडी, हर विज्ञापन ब्रेक इवेंट के लिए बढ़ते क्रम में असाइन किए जाते हैं. इनकी शुरुआत ad_break_id/{string}
मौजूदा विज्ञापन ब्रेक के लिए स्ट्रिंग आइडेंटिफ़ायर. पब्लिशर की ओर से दिए गए विज्ञापन ब्रेक आईडी पर, विज्ञापन पॉड आईडी की तरह पाबंदियां लागू नहीं होती हैं. उस एंडपॉइंट को दिया गया कोई भी अज्ञात विज्ञापन ब्रेक आईडी, लाइव स्ट्रीम इवेंट के लिए एक नया विज्ञापन ब्रेक बनाता है. |
profile_name |
string
अनुरोध की गई Google Ad Manager DAI एन्कोडिंग प्रोफ़ाइल का नाम. एनकोडिंग प्रोफ़ाइल, चुनी गई इवेंट के लिए कॉन्फ़िगर की गई एनकोडिंग प्रोफ़ाइलों में से एक होनी चाहिए. |
segment_number |
integer
यह मौजूदा विज्ञापन पॉड में अनुरोध किए गए सेगमेंट का इंडेक्स होता है. इसकी शुरुआत शून्य से होती है. |
segment_format |
string
अनुरोध किए गए सेगमेंट फ़ॉर्मैट से जुड़ा फ़ाइल एक्सटेंशन.
इन एक्सटेंशन को स्वीकार किया जाता है: |
क्वेरी पैरामीटर
पैरामीटर | ||||||
---|---|---|---|---|---|---|
stream_id |
ज़रूरी है |
string
मौजूदा उपयोगकर्ता के सेशन के लिए स्ट्रीम आईडी. यह वैल्यू, |
||||
sd |
required1
|
integer
अनुरोध किए गए सेगमेंट की अवधि, मिलीसेकंड में. |
||||
so |
वैकल्पिक |
विज्ञापन पॉड में अनुरोध किए गए सेगमेंट का ऑफ़सेट, मिलीसेकंड में.
अगर आपने |
||||
pd |
required2 |
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_identifier}.m3u8;
विज्ञापन पॉड के लिए, अलग-अलग वर्शन वाली HLS प्लेलिस्ट को वापस पाने के लिए एपीआई. |
एचटीटीपी अनुरोध
GET https://dai.google.com/linear/pods/v1/hls/network/{network_code}/custom_asset/{custom_asset_key}/{pod_identifier}.m3u8?stream_id={stream_id}&pd={pod_duration}
पाथ पैरामीटर
पैरामीटर | |
---|---|
network_code |
string
पब्लिशर का Google Ad Manager नेटवर्क कोड. |
custom_asset_key |
string
Google Ad Manager में इस इवेंट से जुड़ा कस्टम आइडेंटिफ़ायर |
pod_identifier |
इन फ़ॉर्मैट का इस्तेमाल किया जा सकता है: pod/{integer}
मौजूदा विज्ञापन ब्रेक का न्यूमेरिक आइडेंटिफ़ायर. विज्ञापन पॉड आईडी, हर विज्ञापन ब्रेक इवेंट के लिए बढ़ते क्रम में असाइन किए जाते हैं. इनकी शुरुआत ad_break_id/{string}
मौजूदा विज्ञापन ब्रेक के लिए स्ट्रिंग आइडेंटिफ़ायर. पब्लिशर की ओर से दिए गए विज्ञापन ब्रेक आईडी पर, विज्ञापन पॉड आईडी की तरह पाबंदियां लागू नहीं होती हैं. उस एंडपॉइंट को दिया गया कोई भी अज्ञात विज्ञापन ब्रेक आईडी, लाइव स्ट्रीम इवेंट के लिए एक नया विज्ञापन ब्रेक बनाता है. |
क्वेरी पैरामीटर
पैरामीटर | ||||||
---|---|---|---|---|---|---|
stream_id |
ज़रूरी है |
string
मौजूदा उपयोगकर्ता के सेशन के लिए स्ट्रीम आईडी. यह वैल्यू, |
||||
pd |
ज़रूरी है |
integer
विज्ञापनों के पॉड की अवधि, मिलीसेकंड में. |
||||
scte35 |
वैकल्पिक |
string
इस विज्ञापन ब्रेक के लिए, Base64 में एन्कोड किया गया SCTE-35 सिग्नल. |
||||
cust_params |
वैकल्पिक |
string
की-वैल्यू पेयर का एक सेट, जिसका इस्तेमाल Ad Manager कैंपेन टारगेटिंग के लिए किया जाता है. इन जोड़ियों को, यूआरएल के लिए कोड में बदली गई क्वेरी स्ट्रिंग के तौर पर दिखाया जाना चाहिए. उदाहरण:
|
जवाब का मुख्य भाग
अगर अनुरोध पूरा हो जाता है, तो जवाब के मुख्य हिस्से में HLS मल्टीवेरिएंट प्लेलिस्ट होती है.
तरीका: डैश पॉड मेनिफ़ेस्ट
यह फ़ंक्शन, लाइव स्ट्रीम के 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
ऑब्जेक्ट शामिल होता है.
तरीका: विज्ञापन पॉड के समय का मेटाडेटा
तरीके | |
---|---|
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
विज्ञापन के अगले ब्रेक का आईडी. विज्ञापन ब्रेक के आईडी, स्टिचिंग सर्वर या वीटीपी से मिलते हैं. ये आईडी, एक ही विज्ञापन ब्रेक के लिए, विज्ञापन ब्रेक की शुरुआती सूचनाओं, विज्ञापन पॉड के समय के मेटाडेटा के अनुरोधों, और सेगमेंट रीडायरेक्ट के अनुरोधों में एक जैसे होने चाहिए. कस्टम विज्ञापन ब्रेक आईडी पर ये पाबंदियां लागू होती हैं:
|
auth-token |
ज़रूरी है |
string
|
timeout |
वैकल्पिक |
integer
यह मिलीसेकंड में वह समय होता है जब डीएआई, विज्ञापन से जुड़े फ़ैसले का इंतज़ार करने के लिए इस अनुरोध को ब्लॉक कर सकता है. इस पैरामीटर का इस्तेमाल उन अनुरोधों पर करें जिनमें पहले अनुरोध पर ही विज्ञापन दिखाने होते हैं. जैसे, प्री-रोल विज्ञापन ब्रेक. अगर टाइम आउट की अवधि खत्म हो जाती है, तो अनुरोध की स्थिति 'लंबित है' के तौर पर दिखती है. अगर इसे शामिल किया जाता है, तो टाइम आउट की वैल्यू 1,000 से 15,000 मिलीसेकंड के बीच होनी चाहिए. अगर इसे शामिल नहीं किया जाता है, तो विज्ञापन के फ़ैसले का इंतज़ार करने के लिए जवाबों में देरी नहीं की जाती है. |
final |
वैकल्पिक |
boolean
इसे यह डिफ़ॉल्ट रूप से |
विज्ञापन के फ़ैसले लेने से जुड़े पैरामीटर |
||
pd |
वैकल्पिक |
integer
विज्ञापन ब्रेक की अवधि (मिलीसेकंड में). इसे विज्ञापन पॉड की अवधि भी कहा जाता है. अगर EABN का इस्तेमाल किया जाता है, तो pd वैल्यू, विज्ञापन ब्रेक की सूचना में दी गई अवधि से मेल खानी चाहिए. अगर अवधि मेल नहीं खाती हैं, तो EABN वैल्यू को प्राथमिकता दी जाएगी. |
cust_params |
वैकल्पिक |
string
विज्ञापन ब्रेक को टारगेट करने के लिए कस्टम पैरामीटर. इनके बारे में Ad Manager सहायता केंद्र में बताया गया है. |
scte35 |
वैकल्पिक |
string
Base64 में एन्कोड किया गया SCTE-35 सिग्नल.
अगर सिग्नल अमान्य है, तो रिस्पॉन्स के |
जवाब का मुख्य भाग
अगर एपीआई सही से जुड़ जाता है, तो जवाब के मुख्य हिस्से में नया AdPodTimingMetadataResponse
ऑब्जेक्ट शामिल होता है.
तरीका: मीडिया की पुष्टि करना
प्लेबैक के दौरान विज्ञापन मीडिया आइडेंटिफ़ायर मिलने के बाद, ऊपर दिए गए stream एंडपॉइंट से मिले media_verification_url का इस्तेमाल करके तुरंत अनुरोध करें. ये अनुरोध, सर्वर-साइड-बीकनिंग वाली उन स्ट्रीम के लिए ज़रूरी नहीं हैं जिनमें सर्वर, मीडिया की पुष्टि शुरू करता है.
media verification
एंडपॉइंट के लिए किए गए अनुरोध, आइडेमपोटेंट होते हैं.
तरीके | |
---|---|
media verification |
GET /{media_verification_url}/{ad_media_id}
यह कुकी, मीडिया की पुष्टि करने वाले इवेंट के बारे में एपीआई को सूचना देती है. |
एचटीटीपी अनुरोध
GET https://{media-verification-url}/{ad-media-id}
जवाब का मुख्य भाग
media verification
ये जवाब देता है:
HTTP/1.1 204 No Content
अगर मीडिया की पुष्टि हो जाती है और सभी पिंग भेज दिए जाते हैं.HTTP/1.1 404 Not Found
अगर यूआरएल का फ़ॉर्मैट गलत है या उसकी समयसीमा खत्म हो गई है, तो अनुरोध मीडिया की पुष्टि नहीं कर सकता.HTTP/1.1 404 Not Found
अगर इस आईडी के लिए, पुष्टि करने का पिछला अनुरोध स्वीकार कर लिया गया हो.HTTP/1.1 409 Conflict
अगर इस समय कोई दूसरा अनुरोध पहले से ही पिंग भेज रहा है.
विज्ञापन मीडिया आईडी
विज्ञापन मीडिया आइडेंटिफ़ायर को अलग मेटाडेटा ट्रैक में कोड में बदला जाएगा. जैसे, एचएलएस ट्रांसपोर्ट स्ट्रीम के लिए टाइम किया गया मेटाडेटा या mp4 फ़ाइलों के लिए emsg. विज्ञापन मीडिया आइडेंटिफ़ायर हमेशा google_
स्ट्रिंग से शुरू होंगे.
विज्ञापन की पुष्टि करने का हर अनुरोध करने से पहले, मेटाडेटा एंट्री के पूरे टेक्स्ट कॉन्टेंट को विज्ञापन की पुष्टि करने वाले यूआरएल में जोड़ना चाहिए.
तरीका: मेटाडेटा
metadata_url
पर मौजूद मेटाडेटा एंडपॉइंट, विज्ञापन यूज़र इंटरफ़ेस (यूआई) बनाने के लिए इस्तेमाल की गई जानकारी दिखाता है. मेटाडेटा एंडपॉइंट, सर्वर-साइड-बीकनिंग स्ट्रीम के लिए उपलब्ध नहीं है. इसमें विज्ञापन मीडिया की पुष्टि शुरू करने की ज़िम्मेदारी सर्वर की होती है.
तरीके | |
---|---|
metadata |
GET /{metadata_url}/{ad-media-id} GET /{metadata_url}
यह कुकी, विज्ञापन के मेटाडेटा की जानकारी वापस पाने के लिए इस्तेमाल की जाती है. |
एचटीटीपी अनुरोध
GET https://{metadata_url}/{ad-media-id}
GET https://{metadata_url}
जवाब का मुख्य भाग
अगर अनुरोध पूरा हो जाता है, तो जवाब में PodMetadata
का एक इंस्टेंस दिखता है.
मेटाडेटा पार्स करना
मेटाडेटा में तीन अलग-अलग सेक्शन होते हैं: tags
, ads
, और विज्ञापन breaks
. डेटा में एंट्री करने का पॉइंट, tags
सेक्शन है. इसके बाद, टैग की सूची में स्क्रोल करें और वह पहली एंट्री ढूंढें जिसका नाम, वीडियो स्ट्रीम में मौजूद विज्ञापन मीडिया आईडी का प्रीफ़िक्स है. उदाहरण के लिए, आपके पास ऐसा विज्ञापन मीडिया आईडी हो सकता है:
google_1234567890
इसके बाद, आपको google_12345
नाम का टैग ऑब्जेक्ट मिलता है. इस मामले में, यह आपके विज्ञापन मीडिया आईडी से मेल खाता है. सही विज्ञापन मीडिया प्रीफ़िक्स ऑब्जेक्ट मिलने के बाद, विज्ञापन आईडी, विज्ञापन ब्रेक आईडी, और इवेंट टाइप देखा जा सकता है. इसके बाद, विज्ञापन आईडी का इस्तेमाल ads
ऑब्जेक्ट को इंडेक्स करने के लिए किया जाता है. साथ ही, विज्ञापन ब्रेक आईडी का इस्तेमाल breaks
ऑब्जेक्ट को इंडेक्स करने के लिए किया जाता है.
जवाब का डेटा
स्ट्रीम
स्ट्रीम का इस्तेमाल, JSON फ़ॉर्मैट में नई बनाई गई स्ट्रीम के लिए संसाधनों की सूची को रेंडर करने के लिए किया जाता है.JSON के काेड में दिखाना |
---|
{ "stream_id": string, "media_verification_url": string, "metadata_url": string, "session_update_url": string, "heartbeat_url": string, "polling_frequency": number, "pod_manifest_url": string, "manifest_format": string, } |
फ़ील्ड | |
---|---|
stream_id |
string यह GAM स्ट्रीम आइडेंटिफ़ायर है. |
media_verification_url |
string मीडिया की पुष्टि करने वाले यूआरएल का इस्तेमाल, वीडियो चलाने से जुड़े इवेंट को ट्रैक करने के लिए बेस एंडपॉइंट के तौर पर किया जाता है. |
metadata_url |
string मेटाडेटा यूआरएल का इस्तेमाल, स्ट्रीम के दौरान दिखने वाले विज्ञापन से जुड़े इवेंट के बारे में समय-समय पर जानकारी पाने के लिए किया जाता है. |
session_update_url |
string इस सेशन के अपडेट यूआरएल का इस्तेमाल, इस स्ट्रीम के टारगेटिंग पैरामीटर को अपडेट करने के लिए किया जाता है. टारगेटिंग पैरामीटर की ओरिजनल वैल्यू, स्ट्रीम बनाने के शुरुआती अनुरोध के दौरान कैप्चर की जाती हैं. |
heartbeat_url |
string हार्टबीट यूआरएल का इस्तेमाल, सर्वर साइड बीकनिंग स्ट्रीम को चालू रखने के लिए किया जाता है. इसे हर {PollingFrequency} सेकंड में पिंग करना ज़रूरी है. सर्वर साइड बीकनिंग स्ट्रीम के लिए भरा गया. |
polling_frequency |
number metadata_url या heartbeat_url के लिए अनुरोध करते समय, पोलिंग फ़्रीक्वेंसी (सेकंड में). |
pod_manifest_url |
string पॉड मेनिफ़ेस्ट यूआरएल टेंप्लेट का इस्तेमाल, स्ट्रीम के पॉड मेनिफ़ेस्ट को वापस पाने के लिए यूआरएल जनरेट करने के लिए किया जाता है. यह यूआरएल, एचएलएस में मल्टीवैरिएंट प्लेलिस्ट के यूआरएल या डैश में एमपीडी से मेल खाता है. यह फ़ील्ड, POD_SERVING_MANIFEST टाइप के डाइनैमिक ऐड इंसर्शन वाले लाइव स्ट्रीम इवेंट के लिए भरा जाता है. https://developers.google.com/ad-manager/api/reference/v202305/LiveStreamEventService.DynamicAdInsertionType |
manifest_format |
string मेनिफ़ेस्ट फ़ॉर्मैट, pod_manifest_url से वापस पाया गया मेनिफ़ेस्ट फ़ॉर्मैट है. यह डैश या एचएलएस में से कोई एक हो सकता है. |
PodMetadata
PodMetadata में विज्ञापनों, विज्ञापन ब्रेक, और मीडिया आईडी टैग के मेटाडेटा की जानकारी होती है.JSON के काेड में दिखाना |
---|
{ "tags": map[string, object(TagSegment)], "ads": map[string, object(Ad)], "ad_breaks": map[string, object(AdBreak)], } |
फ़ील्ड | |
---|---|
tags |
map[string, object(TagSegment)] टैग प्रीफ़िक्स के हिसाब से इंडेक्स किए गए टैग सेगमेंट का मैप. |
ads |
map[string, object(Ad)] विज्ञापन आईडी के हिसाब से इंडेक्स किए गए विज्ञापनों का मैप. |
ad_breaks |
map[string, object(AdBreak)] विज्ञापन के लिए ब्रेक का मैप, जिसे विज्ञापन के लिए ब्रेक के आईडी के हिसाब से इंडेक्स किया गया है. |
TagSegment
TagSegment में विज्ञापन, उसके विज्ञापन ब्रेक, और इवेंट टाइप का रेफ़रंस होता है. type="progress" वाले TagSegment को विज्ञापन मीडिया सत्यापन एंडपॉइंट पर पिंग नहीं किया जाना चाहिए.JSON के काेड में दिखाना |
---|
{ "ad": string, "ad_break_id": string, "type": string, } |
फ़ील्ड | |
---|---|
ad |
string इस टैग के विज्ञापन का आईडी. |
ad_break_id |
string इस टैग के विज्ञापन ब्रेक का आईडी. |
type |
string यह टैग के इवेंट का टाइप है. |
AdBreak
AdBreak, स्ट्रीम में मौजूद एक विज्ञापन ब्रेक के बारे में बताता है. इसमें अवधि, टाइप (मिड/प्री/पोस्ट), और विज्ञापनों की संख्या शामिल होती है.JSON के काेड में दिखाना |
---|
{ "type": string, "duration": number, "expected_duration": number, "ads": number, } |
फ़ील्ड | |
---|---|
type |
string विज्ञापन ब्रेक के मान्य टाइप ये हैं: प्री, मिड, और पोस्ट. |
duration |
number विज्ञापन ब्रेक की कुल अवधि, सेकंड में. |
expected_duration |
number विज्ञापन ब्रेक की अनुमानित अवधि (सेकंड में). इसमें सभी विज्ञापन और कोई भी स्लेट शामिल है. |
ads |
number विज्ञापन के लिए ब्रेक में विज्ञापनों की संख्या. |
विज्ञापन
विज्ञापन, स्ट्रीम में मौजूद किसी विज्ञापन के बारे में बताता है.JSON के काेड में दिखाना |
---|
{ "ad_break_id": string, "position": number, "duration": number, "title": string, "description": string, "advertiser": string, "ad_system": string, "ad_id": string, "creative_id": string, "creative_ad_id": string, "deal_id": string, "clickthrough_url": string, "click_tracking_urls": [], "verifications": [object(Verification)], "slate": boolean, "icons": [object(Icon)], "wrappers": [object(Wrapper)], "universal_ad_id": object(UniversalAdID), "extensions": [], "companions": [object(Companion)], "interactive_file": object(InteractiveFile), } |
फ़ील्ड | |
---|---|
ad_break_id |
string इस विज्ञापन के विज्ञापन ब्रेक का आईडी. |
position |
number विज्ञापन ब्रेक में इस विज्ञापन की पोज़िशन. इसकी शुरुआत 1 से होती है. |
duration |
number विज्ञापन की अवधि (सेकंड में). |
title |
string विज्ञापन का वैकल्पिक टाइटल. |
description |
string विज्ञापन की जानकारी देना ज़रूरी नहीं है. |
advertiser |
string विज्ञापन देने वाले का वैकल्पिक आइडेंटिफ़ायर. |
ad_system |
string विज्ञापन सिस्टम की जानकारी देना ज़रूरी नहीं है. |
ad_id |
string विज्ञापन आईडी (ज़रूरी नहीं). |
creative_id |
string क्रिएटिव आईडी देना ज़रूरी नहीं है. |
creative_ad_id |
string क्रिएटिव विज्ञापन आईडी देना ज़रूरी नहीं है. |
deal_id |
string डील आईडी (ज़रूरी नहीं). |
clickthrough_url |
string क्लिकथ्रू यूआरएल देना ज़रूरी नहीं है. |
click_tracking_urls |
string क्लिक ट्रैकिंग के यूआरएल (ज़रूरी नहीं). |
verifications |
[object(Verification)] ओपन मेज़रमेंट की पुष्टि करने वाली ऐसी वैकल्पिक एंट्री जिनमें क्रिएटिव के प्लेबैक की पुष्टि करने के लिए, तीसरे पक्ष के मेज़रमेंट कोड को लागू करने के लिए ज़रूरी संसाधन और मेटाडेटा शामिल होता है. |
slate |
boolean वैकल्पिक बूलियन से पता चलता है कि मौजूदा एंट्री स्लेट है. |
icons |
[object(Icon)] आइकॉन की सूची. अगर यह खाली है, तो इसे शामिल नहीं किया जाता. |
wrappers |
[object(Wrapper)] रैपर की सूची. अगर यह खाली है, तो इसे शामिल नहीं किया जाता. |
universal_ad_id |
object(UniversalAdID) यूनिवर्सल विज्ञापन आईडी देना ज़रूरी नहीं है. |
extensions |
string VAST में मौजूद सभी <Extension> नोड की वैकल्पिक सूची. |
companions |
[object(Companion)] इस विज्ञापन के साथ दिखाए जा सकने वाले सहयोगी विज्ञापन. |
interactive_file |
object(InteractiveFile) इंटरैक्टिव क्रिएटिव (SIMID) का इस्तेमाल करना ज़रूरी नहीं है. इसे विज्ञापन दिखाने के दौरान दिखाया जाना चाहिए. |
PodTemplateResponse
PodTemplateResponse, पॉड स्टिचिंग के लिए VTP को भेजे गए JSON पेलोड को दिखाता है.JSON के काेड में दिखाना |
---|
{ "dash_period_template": string, "segment_duration_ms": int64, } |
फ़ील्ड | |
---|---|
dash_period_template |
string DashPeriodTemplate, अवधि के लिए xml टेंप्लेट है. स्टिचिंग से पहले, इसमें सही डेटा भरा जाना चाहिए. |
segment_duration_ms |
int64 SegmentDurationMS, अवधि के सेगमेंट की अवधि को मिलीसेकंड में दिखाता है. |
AdpodTimingMetadataResponse
AdpodTimingMetadataResponse में, विज्ञापन पॉड और उसके लिए सेगमेंट यूआरएल बनाने के तरीके के बारे में जानकारी होती है.JSON के काेड में दिखाना |
---|
{ "status": string, "ads": [object(AdRendering)], "slate": object(SlateRendering), "dash_representations": map[string, object(DASHRepresentation)], "dash_adaptation_sets": map[string, object(DASHAdaptationSet)], } |
फ़ील्ड | |
---|---|
status |
string विज्ञापन पॉड के लिए फ़ैसले का स्टेटस. |
ads |
[object(AdRendering)] विज्ञापन ऑब्जेक्ट का कलेक्शन. इसमें विज्ञापन सेगमेंट के यूआरएल को रेंडर करने का तरीका बताया गया है. इनकी इंडेक्सिंग 0 से शुरू होती है. |
slate |
object(SlateRendering) स्लेट, जिसमें स्लेट सेगमेंट के यूआरएल रेंडर करने का तरीका बताया गया है. |
dash_representations |
map[string, object(DASHRepresentation)] उस विज्ञापन पॉड के लिए DASH रिप्रेजेंटेशन की सूची, जिसे DASH मेनिफ़ेस्ट में रेंडर किया जाना है. |
dash_adaptation_sets |
map[string, object(DASHAdaptationSet)] उस विज्ञापन पॉड के लिए DASH अडैप्टेशन सेट की सूची, जिसे DASH मेनिफ़ेस्ट में रेंडर किया जाना है. |
AdRendering
AdRendering, फ़ैसले के आधार पर चुने गए विज्ञापन को रेंडर करने का तरीका बताता है.JSON के काेड में दिखाना |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
फ़ील्ड | |
---|---|
duration_ms |
number विज्ञापन की अवधि, मिलीसेकंड में (int). |
variants |
map[string, object(VariantRendering)] वैरिएंट ऑब्जेक्ट की डिक्शनरी (नीचे देखें). इसे यूज़र इंटरफ़ेस (यूआई) से कॉन्फ़िगर किए गए वैरिएंट/प्रोफ़ाइल आईडी के हिसाब से इंडेक्स किया जाता है. |
SlateRendering
SlateRendering में, स्लेट कॉन्टेंट को रेंडर करने का तरीका बताया गया है.JSON के काेड में दिखाना |
---|
{ "duration_ms": number, "variants": map[string, object(VariantRendering)], } |
फ़ील्ड | |
---|---|
duration_ms |
number स्लेट की अवधि, मिलीसेकंड में (int). |
variants |
map[string, object(VariantRendering)] वैरिएंट ऑब्जेक्ट की डिक्शनरी, जिसे वैरिएंट/प्रोफ़ाइल आईडी के हिसाब से इंडेक्स किया जाता है. स्लेट की अवधि को तब तक लूप किया जाना चाहिए, जब तक स्लेट की ज़रूरी लंबाई पूरी न हो जाए. इसके लिए, हर बार स्लेट की अवधि को लूप करने के बीच में एचएलएस डिसकंटिन्यूटी डालें या MPEG-DASH के लिए नई अवधि को लूप करें. |
VariantRendering
VariantRendering, विज्ञापन/स्लेट में मौजूद किसी एक वैरिएंट/प्रोफ़ाइल के बारे में बताता है.JSON के काेड में दिखाना |
---|
{ "segment_extension": string, "segment_durations": object(SegmentDurations), } |
फ़ील्ड | |
---|---|
segment_extension |
string स्ट्रिंग, इनमें से कोई एक: ts, mp4, aac, ac3, ec3, m4a, m4v. सेगमेंट के यूआरएल का फ़ाइल नाम एक्सटेंशन वाला हिस्सा. |
segment_durations |
object(SegmentDurations) SegmentDurations ऑब्जेक्ट. हर सेगमेंट की अवधि को सेगमेंट यूआरएल में बदला जा सकता है. |
SegmentDurations
SegmentDurations, किसी तय समय इकाई में सेगमेंट के क्रम की अवधि के बारे में बताता है.JSON के काेड में दिखाना |
---|
{ "timescale": number, "values": [], } |
फ़ील्ड | |
---|---|
timescale |
number टाइमस्केल, हर सेकंड में यूनिट की संख्या होती है (int) यह इस तरह से होना चाहिए: एचएलएस के लिए 1000 (मिलीसेकंड) डैश वीडियो के लिए 90000 (पीटीएस) डैश ऑडियो के लिए ऑडियो सैंपल रेट. |
values |
number टाइमस्केल यूनिट में, int सेगमेंट की अवधि का कलेक्शन. |
DASHRepresentation
DASHRepresentation, DASH मेनिफ़ेस्ट में रेंडर किए जाने वाले Representation नोड के बारे में बताता है.JSON के काेड में दिखाना |
---|
{ "codecs": string, "bandwidth": number, "width": number, "height": number, "frame_rate": string, "audio_sampling_rate": number, "audio_channel_config": object(SchemeIDURIAndValue), } |
फ़ील्ड | |
---|---|
codecs |
string रिप्रेज़ेंटेशन के कोडेक. |
bandwidth |
number रिप्रेज़ेंटेशन का बैंडविथ. |
width |
number रिप्रेज़ेंटेशन की चौड़ाई. |
height |
number रिप्रेज़ेंटेशन की ऊंचाई. |
frame_rate |
string रिप्रेज़ेंटेशन का फ़्रेम रेट. |
audio_sampling_rate |
number रिप्रेज़ेंटेशन का ऑडियो सैंपलिंग रेट. |
audio_channel_config |
object(SchemeIDURIAndValue) रिप्रेज़ेंटेशन का ऑडियो चैनल कॉन्फ़िगरेशन. |
DASHAdaptationSet
DASHAdaptationSet, DASH मेनिफ़ेस्ट में रेंडर किए जाने वाले AdaptationSet नोड के बारे में बताता है.JSON के काेड में दिखाना |
---|
{ "content_type": string, "mime_type": string, "role": object(SchemeIDURIAndValue), "inband_event_stream": object(SchemeIDURIAndValue), "min_frame_rate": string, "max_frame_rate": string, "scan_type": string, "start_with_sap": string, "segment_alignment": boolean, "representations": [], } |
फ़ील्ड | |
---|---|
content_type |
string एडैप्टेशन सेट का कॉन्टेंट टाइप. |
mime_type |
string ऐडैप्टेशन सेट का MIME टाइप. |
role |
object(SchemeIDURIAndValue) अनुकूलन सेट की भूमिका. |
inband_event_stream |
object(SchemeIDURIAndValue) यह अडैप्टेशन सेट की इनबैंड इवेंट स्ट्रीम है. |
min_frame_rate |
string एडैप्टेशन सेट की कम से कम फ़्रेम दर. |
max_frame_rate |
string अनुकूलन सेट का ज़्यादा से ज़्यादा फ़्रेम रेट. |
scan_type |
string अडैप्टेशन सेट का स्कैन टाइप. |
start_with_sap |
string अनुकूलन सेट के एसएपी से शुरू करें. |
segment_alignment |
boolean ऐडप्टेशन सेट का सेगमेंट अलाइनमेंट. |
representations |
string अनुकूलन सेट के वर्शन. |
SchemeIDURIAndValue
SchemeIDURIAndValue, स्कीम आईडी और उसकी वैल्यू का पेयर होता है.JSON के काेड में दिखाना |
---|
{ "scheme_id_uri": string, "value": string, } |
फ़ील्ड | |
---|---|
scheme_id_uri |
string वैल्यू का स्कीम आईडी यूआरआई. |
value |
string स्कीम आईडी यूआरआई की वैल्यू. |
आइकॉन
इस आइकॉन में VAST आइकॉन के बारे में जानकारी होती है.JSON के काेड में दिखाना |
---|
{ "click_data": object(ClickData), "creative_type": string, "click_fallback_images": [object(FallbackImage)], "height": int32, "width": int32, "resource": string, "type": string, "x_position": string, "y_position": string, "program": string, "alt_text": string, } |
फ़ील्ड | |
---|---|
click_data |
object(ClickData) |
creative_type |
string |
click_fallback_images |
[object(FallbackImage)] |
height |
int32 |
width |
int32 |
resource |
string |
type |
string |
x_position |
string |
y_position |
string |
program |
string |
alt_text |
string |
ClickData
ClickData में, आइकॉन पर क्लिक करने से जुड़ी जानकारी होती है.JSON के काेड में दिखाना |
---|
{ "url": string, } |
फ़ील्ड | |
---|---|
url |
string |
FallbackImage
FallbackImage में VAST फ़ॉलबैक इमेज के बारे में जानकारी होती है.JSON के काेड में दिखाना |
---|
{ "creative_type": string, "height": int32, "width": int32, "resource": string, "alt_text": string, } |
फ़ील्ड | |
---|---|
creative_type |
string |
height |
int32 |
width |
int32 |
resource |
string |
alt_text |
string |
Wrapper
रैपर में, रैपर विज्ञापन के बारे में जानकारी होती है. अगर डील आईडी मौजूद नहीं है, तो उसे शामिल नहीं किया जाता.JSON के काेड में दिखाना |
---|
{ "system": string, "ad_id": string, "creative_id": string, "creative_ad_id": string, "deal_id": string, } |
फ़ील्ड | |
---|---|
system |
string विज्ञापन सिस्टम आइडेंटिफ़ायर. |
ad_id |
string रैपर विज्ञापन के लिए इस्तेमाल किया गया विज्ञापन आईडी. |
creative_id |
string रैपर विज्ञापन के लिए इस्तेमाल किया गया क्रिएटिव आईडी. |
creative_ad_id |
string रैपर विज्ञापन के लिए इस्तेमाल किया गया क्रिएटिव विज्ञापन आईडी. |
deal_id |
string रैपर विज्ञापन के लिए डील आईडी. हालांकि, यह ज़रूरी नहीं है. |
पुष्टि
पुष्टि करने की प्रोसेस में ओपन मेज़रमेंट की जानकारी शामिल होती है. इससे तीसरे पक्ष को व्यूएबिलिटी और पुष्टि करने से जुड़े मेज़रमेंट में मदद मिलती है. फ़िलहाल, सिर्फ़ JavaScript रिसॉर्स इस्तेमाल किए जा सकते हैं. https://iabtechlab.com/standards/open-measurement-sdk/ पर जाएंJSON के काेड में दिखाना |
---|
{ "vendor": string, "java_script_resources": [object(JavaScriptResource)], "tracking_events": [object(TrackingEvent)], "parameters": string, } |
फ़ील्ड | |
---|---|
vendor |
string पुष्टि करने वाली कंपनी. |
java_script_resources |
[object(JavaScriptResource)] पुष्टि के लिए JavaScript संसाधनों की सूची. |
tracking_events |
[object(TrackingEvent)] पुष्टि करने के लिए, ट्रैकिंग इवेंट की सूची. |
parameters |
string 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 अगर यह स्टैटिक टाइप का कंपैनियन है, तो 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 संसाधन के तौर पर दी गई फ़ाइल का एमआईएमई टाइप. |
variable_duration |
boolean इस क्रिएटिव में, अवधि बढ़ाने के लिए कहा जा सकता है या नहीं. |
ad_parameters |
string VAST में <AdParameters> नोड की वैल्यू. |