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

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

सेवा: dai.google.com

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

तरीका: स्ट्रीम बनाएं

यह तरीका, सीधे डिवाइस से स्ट्रीम बनाता है. साथ ही, क्लाइंट ऐप्लिकेशन को विज्ञापन चलाने और ट्रैक करने के लिए ज़रूरी सभी संसाधन उपलब्ध कराता है. इसके अलावा, यह यूज़र इंटरफ़ेस (यूआई) एलिमेंट भी दिखाता है.

तरीके
create stream POST: /ondemand/pods/api/v1/network/{network_code}/stream

डीएआई पॉड से वीडियो ऑन डिमांड (वीओडी) सेशन को दिखाने की सुविधा चालू करें.

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

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/stream

पाथ पैरामीटर

पैरामीटर
network_code string

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

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा application/json टाइप का है. इसमें CreateStreamRequest ऑब्जेक्ट होना चाहिए.

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

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

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

यह तरीका, डिवाइस से Google DAI बैकएंड पर स्ट्रीम रजिस्टर करता है. साथ ही, क्लाइंट ऐप्लिकेशन को विज्ञापन ट्रैक करने और यूज़र इंटरफ़ेस (यूआई) एलिमेंट दिखाने के लिए ज़रूरी सभी संसाधन वापस भेजता है. create stream तरीके के उलट, यह तरीका खेलने लायक विज्ञापन का मेनिफ़ेस्ट नहीं दिखाता है. इसके बजाय, यह कार्रवाई अलग सर्वर कॉल में की जाती है: decision ad pods.

तरीके
register stream POST: /ondemand/pods/api/v1/network/{network_code}/stream_registration

यह कुकी, VOD सेशन दिखाने वाले DAI पॉड को रजिस्टर करती है.

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

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/stream_registration

पाथ पैरामीटर

पैरामीटर
network_code string

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

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा application/json टाइप का है. इसमें StreamRegistrationRequest ऑब्जेक्ट होना चाहिए.

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

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

तरीका: विज्ञापन पॉड वापस पाएं

यह तरीका, डिवाइस से किए गए register stream कॉल का पालन करता है. साथ ही, कॉन्टेंट मेनिफ़ेस्ट में स्टिच करने के लिए, चलाने लायक विज्ञापन मेनिफ़ेस्ट को वापस पाने के लिए ज़रूरी है.

तरीके
decision ad pods POST: /ondemand/pods/api/v1/network/{network_code}/streams/{stream_id}/adpods

वीओडी सेशन के लिए, डीएआई पॉड दिखाने के लिए विज्ञापनों के पॉड से जुड़ा फ़ैसला.

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

POST https://dai.google.com/ondemand/pods/api/v1/network/{network_code}/streams/{stream_id}/adpods

पाथ पैरामीटर

पैरामीटर
network_code string

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

stream_id string

stream_registration कॉल से मिला stream_id.

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा application/json टाइप का है. इसमें AdPodDecisionRequest ऑब्जेक्ट होना चाहिए.

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

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

तरीका: विज्ञापनों के पॉड का मेटाडेटा

यह तरीका, क्लाइंट ऐप्लिकेशन को विज्ञापन ट्रैक करने के लिए ज़रूरी सभी जानकारी देता है. साथ ही, यूज़र इंटरफ़ेस (यूआई) के सही एलिमेंट को सटीक तरीके से रेंडर करता है.

तरीके
ad pods metadata GET: /ondemand/pods/api/v1/network/.../metadata

किसी सेशन के लिए विज्ञापन पॉड का मेटाडेटा वापस पाएं. यह यूआरएल, StreamRegistrationResponse metadata_url एट्रिब्यूट में दिखता है.

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

GET: /ondemand/pods/api/v1/network/.../metadata

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

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

Data

PodMetadata

PodMetadata में विज्ञापनों, विज्ञापन ब्रेक, और मीडिया आईडी टैग के मेटाडेटा की जानकारी होती है.
JSON के काेड में दिखाना
{
  "tags": map[string, object(TagSegment)],
  "ads": map[string, object(Ad)],
  "ad_breaks": map[string, object(AdBreak)],
  "polling_frequency": number,
}
फ़ील्ड
tags map[string, object(TagSegment)]

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

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

विज्ञापन के लिए ब्रेक का मैप, जिसे विज्ञापन के लिए ब्रेक के आईडी के हिसाब से इंडेक्स किया गया है.
polling_frequency number

मेटाडेटा यूआरएल की पोलिंग फ़्रीक्वेंसी का सुझाव दिया गया है. यह फ़्रीक्वेंसी सेकंड में होती है. इस फ़ील्ड में, वीओडी स्ट्रीम के लिए मांग के हिसाब से फ़ैसले लेने की सुविधा का इस्तेमाल करके जानकारी भरी जाती है.

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) दिखाना ज़रूरी नहीं है. इसे विज्ञापन दिखाने के दौरान दिखाया जाना चाहिए.

MatchOpts

MatchOpts, किसी स्ट्रीम के लिए मीडिया मैचिंग की ज़रूरी शर्तों के बारे में बताते हैं.
JSON के काेड में दिखाना
{
  "audio_channels": boolean,
  "audio_sample_rate": boolean,
}
फ़ील्ड
audio_channels boolean

कॉन्टेंट और विज्ञापनों के ऑडियो चैनल मैच करें.
audio_sample_rate boolean

कॉन्टेंट और विज्ञापनों के ऑडियो सैंपल रेट को एक जैसा रखें.

CreateStreamRequest

CreateStreamRequest, VOD पॉड सर्व करने वाले एपीआई को किए गए एचटीटीपी अनुरोधों में मौजूद जानकारी के बारे में बताता है. हर उपयोगकर्ता के लिए, स्ट्रीम बनाने की प्रोसेस को वीटीपी (वीडियो टेक्नोलॉजी पार्टनर) शुरू करता है. यह प्रोसेस, एसडीके और पब्लिशर की ओर से शुरू की जाती है. स्ट्रीम बनाने पर, वीटीपी के लिए विज्ञापनों के पॉड तय किए जाते हैं, ताकि उन्हें स्टिच किया जा सके. यह StreamRegistrationRequest+AdPodDecisionRequest फ़्लो से अलग है. इसमें एक स्ट्रीम और फ़ैसलों वाले विज्ञापन पॉड को कई अनुरोधों में रजिस्टर किया जाता है.
JSON के काेड में दिखाना
{
  "encoding_profiles": [object(EncodingProfile)],
  "ad_tag": string,
  "cuepoints": [],
  "manifest_type": string,
  "enable_hls_asset_list": boolean,
  "targeting_parameters": map[string, string],
  "content_duration_seconds": number,
  "decision_timing_options": object(DecisionTimingOptions),
  "enable_inline_manifests": boolean,
  "dai_options": object(CreateStreamOptions),
}
फ़ील्ड
encoding_profiles [object(EncodingProfile)]

एन्कोडिंग प्रोफ़ाइलों की सूची. ज़रूरी है.
ad_tag string

विज्ञापन दिखाने का फ़ैसला लेने के लिए, यह बुनियादी विज्ञापन टैग है. ज़रूरी है.
cuepoints number

सेकंड में क्यूपॉइंट की सूची. विज्ञापन टैग के जवाब में पोज़िशनल टाइम ऑफ़सेट का इस्तेमाल करने पर, यह पैरामीटर ज़रूरी है.
manifest_type string

मान्य मेनिफ़ेस्ट टाइप ये हैं: hls और dash. डिफ़ॉल्ट: hls. ज़रूरी नहीं.
enable_hls_asset_list boolean

इससे पता चलता है कि एचएलएस ऐसेट की सूची वाले इंटरस्टीशियल विज्ञापन चालू हैं या नहीं. इस सुविधा के चालू होने पर, डीएआई हर विज्ञापन ब्रेक के लिए ऐसेट की सूची वाले यूआरएल दिखाएगा. इनका इस्तेमाल, एचएलएस इंटरस्टीशियल के लिए किया जा सकता है.
targeting_parameters string

Ad Manager के अतिरिक्त टारगेटिंग पैरामीटर. ज़रूरी नहीं.
content_duration_seconds number

ContentDurationSeconds, कॉन्टेंट की अवधि को सेकंड में दिखाता है. यह तब ज़रूरी होता है, जब विज्ञापन टैग के जवाब में समय के ऑफ़सेट के प्रतिशत का इस्तेमाल किया जाता है.
decision_timing_options object(DecisionTimingOptions)

इससे पता चलता है कि विज्ञापन पॉड के बारे में फ़ैसला कब लिया जाना चाहिए.
enable_inline_manifests boolean

इससे पता चलता है कि ब्रेक मेनिफ़ेस्ट को JSON रिस्पॉन्स में इनलाइन किया जाना चाहिए या नहीं.
dai_options object(CreateStreamOptions)

स्ट्रीम बनाने के लिए DAIOptions.

CreateStreamOptions

CreateStreamOptions, स्ट्रीम बनाने के एक चरण वाले वर्कफ़्लो में उपलब्ध विकल्पों को दिखाता है.
JSON के काेड में दिखाना
{
  "dash_profile": string,
  "match_options": object(MatchOpts),
  "data_sharing_policy_code": string,
  "sam_id": string,
  "session_title": string,
  "dash_inband_event_stream": boolean,
  "distinct_ad_profiles": boolean,
  "tracking_mode": string,
  "emsg_version": uint32,
}
फ़ील्ड
dash_profile string

इस्तेमाल की जाने वाली MPEG-DASH प्रोफ़ाइल, 'लाइव' या 'मांग पर'.
match_options object(MatchOpts)

data_sharing_policy_code string

इस कुकी की मदद से पब्लिशर, नेटवर्क की डिफ़ॉल्ट डेटा शेयरिंग नीति को बदल सकते हैं.
sam_id string

sam_id, सेशन के लिए SAM डीबग कुंजी है. यह ज़रूरी नहीं है.
session_title string

session_title, स्ट्रीम के लिए SAM सेशन का टाइटल है. यह वैकल्पिक है.
dash_inband_event_stream boolean

dash_inband_event_stream से पता चलता है कि DAI, ID3 मैसेज को EventStream एलिमेंट (इन-मैनिफ़ेस्ट) के बजाय, InbandEventStream एलिमेंट का इस्तेमाल करके इनबैंड इवेंट (इन-मीडिया) के तौर पर डालता है.
distinct_ad_profiles boolean

अगर इसे सही पर सेट किया जाता है, तो इसका मतलब है कि सर्वर, अनुरोध की गई एन्कोडिंग प्रोफ़ाइलों से मैच करते समय, उपलब्ध किसी भी विज्ञापन प्रोफ़ाइल का इस्तेमाल ज़्यादा से ज़्यादा एक बार करेगा.
tracking_mode string

tracking_mode, स्ट्रीम के लिए इस्तेमाल की जाने वाली विज्ञापन ट्रैकिंग का टाइप है. यह विकल्प के तौर पर उपलब्ध है. मान्य वैल्यू ये हैं: 'ad_media', 'server', 'client'.
emsg_version uint32

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

StreamRegistrationRequest

StreamRegistrationRequest, डिवाइस से स्ट्रीम को रजिस्टर करता है, ताकि आने वाले समय में विज्ञापन पॉड के बारे में फ़ैसला लिया जा सके. इसके उलट, CreateStreamRequest एक ऐसा अनुरोध है जो एक ही अनुरोध में स्ट्रीम और फ़ैसले वाले विज्ञापन पॉड बनाता है.
JSON के काेड में दिखाना
{
  "targeting_parameters": map[string, string],
  "dai_options": object(StreamRegistrationOptions),
}
फ़ील्ड
targeting_parameters string

Ad Manager के अतिरिक्त टारगेटिंग पैरामीटर. ज़रूरी नहीं.
dai_options object(StreamRegistrationOptions)

स्ट्रीम रजिस्ट्रेशन के लिए DAIOptions.

StreamRegistrationOptions

StreamRegistrationOptions में, स्ट्रीम बनाने के लिए उपलब्ध विकल्पों की सूची दी गई है
JSON के काेड में दिखाना
{
  "sam_id": string,
  "tracking_mode": string,
  "emsg_version": uint32,
  "skippable_ads_supported": boolean,
}
फ़ील्ड
sam_id string

sam_id, सेशन के लिए SAM डीबग कुंजी है. यह ज़रूरी नहीं है.
tracking_mode string

tracking_mode, स्ट्रीम के लिए इस्तेमाल की जाने वाली विज्ञापन ट्रैकिंग का टाइप है. यह विकल्प के तौर पर उपलब्ध है. मान्य वैल्यू ये हैं: 'ad_media', 'server', 'client'.
emsg_version uint32

emsg_version, मीडिया में मौजूद आईडी3 टैग के लिए, किसी खास ईएमएसजी वर्शन का इस्तेमाल करने के लिए मजबूर करता है. यह सिर्फ़ तब काम करता है, जब dash_inband_event_stream सही पर सेट हो.
skippable_ads_supported boolean

इससे पता चलता है कि स्किप किए जा सकने वाले विज्ञापन दिखाए जा सकते हैं या नहीं.

StreamRegistrationResponse

StreamRegistrationResponse, क्लाइंट को StreamRegistrationRequest के जवाब में भेजे गए JSON रिस्पॉन्स को दिखाता है. इसमें स्ट्रीम आईडी और डिवाइस के लिए ज़रूरी सभी यूआरएल शामिल होते हैं. स्ट्रीम आईडी का इस्तेमाल, विज्ञापन पॉड के फ़ैसले के लिए किए गए बाद के अनुरोध में किया जा सकता है. यह CreateStreamResponse से अलग है. CreateStreamResponse, स्ट्रीम बनाने और एक ही समय में विज्ञापन पॉड का फ़ैसला लेने के लिए एक जवाब दिखाता है.
JSON के काेड में दिखाना
{
  "stream_id": string,
  "media_verification_url": string,
  "valid_for": string,
  "valid_until": string,
  "metadata_url": string,
}
फ़ील्ड
stream_id string

StreamID, दर्शक की मौजूदा स्ट्रीम का यूनीक आइडेंटिफ़ायर है.
media_verification_url string

MediaVerificationURL, यूआरएल का वह प्रीफ़िक्स है जिसका इस्तेमाल विज्ञापन के मीडिया की पुष्टि करने के लिए किया जाता है. इसके बारे में यहां बताया गया है. क्लाइंट साइड पर बीकन भेजने वाली स्ट्रीम के लिए मौजूद नहीं है.
valid_for string

ValidFor, वह अवधि होती है जिसके लिए यह स्ट्रीम मान्य होती है. इसे "00h00m00s" फ़ॉर्मैट में दिखाया जाता है.
valid_until string

ValidUntil, वह तारीख और समय है जब तक यह स्ट्रीम मान्य है.
metadata_url string

MetadataURL, विज्ञापन पॉड के मेटाडेटा का अनुरोध करने के लिए इस्तेमाल किया जाने वाला मेटाडेटा यूआरएल है.

DecisionTimingOptions

DecisionTimingOptions, स्ट्रीम के लिए विज्ञापन ब्रेक के फ़ैसले लेने के समय के विकल्पों के बारे में बताता है.
JSON के काेड में दिखाना
{
  "type": string,
  "on_create_breaks": [],
}
फ़ील्ड
type string

टाइप से पता चलता है कि स्ट्रीम के लिए विज्ञापन पॉड कब तय किए जाते हैं. मान्य टाइप ये हैं: on_create (डिफ़ॉल्ट), on_demand. जब टाइप on_demand होता है, तो किसी ब्रेक के लिए मेनिफ़ेस्ट का अनुरोध किए जाने पर, विज्ञापनों को तुरंत नहीं दिखाया जाता है. टाइप on_create होने पर, स्ट्रीम बनाते समय ही सभी विज्ञापनों के बारे में फ़ैसला ले लिया जाता है.
on_create_breaks string

OnCreateBreaks, केस-सेंसिटिव VMAP breakID की एक सूची है. इसका इस्तेमाल स्ट्रीम बनाने के दौरान फ़ैसला लेने के लिए किया जाना चाहिए. इस फ़ील्ड का इस्तेमाल सिर्फ़ तब किया जा सकता है, जब टाइप on_demand हो. विज्ञापन के लिए खास ब्रेक आइडेंटिफ़ायर "preroll" और "postroll" का इस्तेमाल यह बताने के लिए किया जा सकता है कि स्ट्रीम बनाने के समय, प्रीरोल या पोस्टरोल ब्रेक का फ़ैसला लिया जाना चाहिए.

EncodingProfile

EncodingProfile, कॉन्टेंट के किसी एक वैरिएंट की एन्कोडिंग के बारे में बताता है. इसमें सिर्फ़ वीडियो सेटिंग, सिर्फ़ ऑडियो सेटिंग (मीडिया टाइप के मामले में), वीडियो और ऑडियो, दोनों सेटिंग या सबटाइटल के मामले में, इनमें से कोई भी सेटिंग नहीं हो सकती.
JSON के काेड में दिखाना
{
  "profile_name": string,
  "type": string,
  "container_type": string,
  "video_settings": object(VideoSettings),
  "audio_settings": object(AudioSettings),
  "subtitle_settings": object(SubtitleSettings),
}
फ़ील्ड
profile_name string

यह पब्लिशर की ओर से दी गई प्रोफ़ाइल का नाम है. हर स्ट्रीम के लिए यूनीक होना चाहिए. ज़रूरी है.
type string

मान्य टाइप: मीडिया, iframe, सबटाइटल. ज़रूरी है.
container_type string

मान्य टाइप: mpeg2ts, fmp4cmaf, और hls_packed_audio. टाइप मीडिया और iframe के लिए ज़रूरी है.
video_settings object(VideoSettings)

अगर कंटेनर टाइप iframe है, तो वीडियो की सेटिंग ज़रूरी हैं. इसके अलावा, ये सिर्फ़ तब मौजूद होते हैं, जब प्रोफ़ाइल में वीडियो मौजूद हो.
audio_settings object(AudioSettings)

अगर प्रोफ़ाइल में ऑडियो मौजूद है, तो ऑडियो सेटिंग दिखेंगी. ऑडियो सेटिंग की अनुमति सिर्फ़ तब होती है, जब कंटेनर टाइप मीडिया हो.
subtitle_settings object(SubtitleSettings)

टाइप किए गए सबटाइटल के लिए, सबटाइटल की सेटिंग ज़रूरी होती हैं.

VideoSettings

VideoSettings, एन्कोडिंग प्रोफ़ाइल के वीडियो के बारे में बताता है. अगर वीडियो की कोई सेटिंग मौजूद है, तो सभी सेटिंग मौजूद होनी चाहिए.
JSON के काेड में दिखाना
{
  "codec": string,
  "bitrate": int32,
  "frames_per_second": number,
  "resolution": object(Resolution),
}
फ़ील्ड
codec string

यह वीडियो की RFC6381 कोडेक स्ट्रिंग है.
bitrate int32

एन्कोडिंग प्रोफ़ाइल का ज़्यादा से ज़्यादा वीडियो बिटरेट.
frames_per_second number

वीडियो के फ़्रेम प्रति सेकंड.
resolution object(Resolution)

वीडियो की चौड़ाई x ऊंचाई का रिज़ॉल्यूशन.

AudioSettings

AudioSettings, एन्कोडिंग प्रोफ़ाइल के ऑडियो के बारे में बताता है. अगर कोई ऑडियो सेटिंग मौजूद है, तो सभी मौजूद होनी चाहिए.
JSON के काेड में दिखाना
{
  "codec": string,
  "bitrate": int32,
  "channels": int32,
  "sample_rate": int64,
}
फ़ील्ड
codec string

यह ऑडियो की RFC6381 कोडेक स्ट्रिंग है.
bitrate int32

एन्कोडिंग प्रोफ़ाइल के लिए ज़्यादा से ज़्यादा ऑडियो बिटरेट.
channels int32

ऑडियो चैनलों की संख्या (इसमें कम फ़्रीक्वेंसी वाले चैनल भी शामिल हैं).
sample_rate int64

ऑडियो का सैंपल रेट, हर्ट्ज़ में.

SubtitleSettings

SubtitleSettings, एन्कोडिंग प्रोफ़ाइलों के सबटाइटल के बारे में बताता है.
JSON के काेड में दिखाना
{
  "format": string,
  "language": string,
}
फ़ील्ड
format string

सबटाइटल का फ़ॉर्मैट: एचएलएस के लिए webvtt और डैश के लिए webvtt या ttml.
language string

मेनिफ़ेस्ट में डालने के लिए भाषा.

रिज़ॉल्यूशन

रिज़ॉल्यूशन से वीडियो की चौड़ाई x ऊंचाई के बारे में पता चलता है.
JSON के काेड में दिखाना
{
  "width": int32,
  "height": int32,
}
फ़ील्ड
width int32

पिक्सल में, वीडियो की चौड़ाई. ज़रूरी है.
height int32

पिक्सल में, वीडियो की ऊंचाई. ज़रूरी है.

AdPodDecisionRequest

AdPodDecisionRequest, पहले से रजिस्टर की गई स्ट्रीम के लिए, फ़ैसले लेने वाले adpods से किया गया अनुरोध होता है.
JSON के काेड में दिखाना
{
  "encoding_profiles": [object(EncodingProfile)],
  "ad_tag": string,
  "cuepoints": [],
  "manifest_type": string,
  "enable_hls_asset_list": boolean,
  "targeting_parameters": map[string, string],
  "content_duration_seconds": number,
  "decision_timing_options": object(DecisionTimingOptions),
  "enable_inline_manifests": boolean,
  "dai_options": object(AdPodDecisionOptions),
}
फ़ील्ड
encoding_profiles [object(EncodingProfile)]

एन्कोडिंग प्रोफ़ाइलों की सूची. ज़रूरी है.
ad_tag string

विज्ञापन दिखाने का फ़ैसला लेने के लिए, यह बुनियादी विज्ञापन टैग है. ज़रूरी है.
cuepoints number

सेकंड में क्यूपॉइंट की सूची. विज्ञापन टैग के जवाब में पोज़िशनल टाइम ऑफ़सेट का इस्तेमाल करने पर, यह पैरामीटर ज़रूरी है.
manifest_type string

मान्य मेनिफ़ेस्ट टाइप ये हैं: hls और dash. डिफ़ॉल्ट: hls. ज़रूरी नहीं.
enable_hls_asset_list boolean

इससे पता चलता है कि एचएलएस ऐसेट की सूची वाले इंटरस्टीशियल विज्ञापन चालू हैं या नहीं. इस सुविधा के चालू होने पर, डीएआई हर विज्ञापन ब्रेक के लिए ऐसेट की सूची वाले यूआरएल दिखाएगा. इनका इस्तेमाल, एचएलएस इंटरस्टीशियल के लिए किया जा सकता है.
targeting_parameters string

Ad Manager के अतिरिक्त टारगेटिंग पैरामीटर. ज़रूरी नहीं.
content_duration_seconds number

ContentDurationSeconds, कॉन्टेंट की अवधि को सेकंड में दिखाता है. यह तब ज़रूरी होता है, जब विज्ञापन टैग के जवाब में समय के ऑफ़सेट के प्रतिशत का इस्तेमाल किया जाता है.
decision_timing_options object(DecisionTimingOptions)

इससे पता चलता है कि विज्ञापन पॉड के बारे में फ़ैसला कब लिया जाना चाहिए.
enable_inline_manifests boolean

इससे पता चलता है कि ब्रेक मेनिफ़ेस्ट को JSON रिस्पॉन्स में इनलाइन किया जाना चाहिए या नहीं.
dai_options object(AdPodDecisionOptions)

विज्ञापनों के पॉड के बारे में फ़ैसला लेने के लिए DAIOptions.

AdPodDecisionResponse

AdPodDecisionResponse, पहले से रजिस्टर की गई स्ट्रीम के लिए, फ़ैसले लेने वाले विज्ञापन पॉड के जवाब को दिखाता है. इसमें उस स्ट्रीम के लिए तय किए गए विज्ञापन पॉड की सूची होती है.
JSON के काेड में दिखाना
{
  "valid_for": string,
  "valid_until": string,
  "ad_pods": [object(AdPod)],
}
फ़ील्ड
valid_for string

ValidFor, वह अवधि होती है जिसके लिए यह स्ट्रीम मान्य होती है. इसे "00h00m00s" फ़ॉर्मैट में दिखाया जाता है.
valid_until string

ValidUntil, वह तारीख और समय है जब तक यह स्ट्रीम मान्य है.
ad_pods [object(AdPod)]

इंसर्शन ऑर्डर के हिसाब से क्रम में लगाए गए विज्ञापन पॉड की सूची.

CreateStreamResponse

CreateStreamResponse, क्लाइंट को वापस भेजे गए JSON रिस्पॉन्स को दिखाता है. यह रिस्पॉन्स, CreateStreamRequest के जवाब में भेजा जाता है.
JSON के काेड में दिखाना
{
  "valid_for": string,
  "valid_until": string,
  "ad_pods": [object(AdPod)],
  "stream_id": string,
  "media_verification_url": string,
  "pod_metadata": object(PodMetadata),
  "metadata_url": string,
}
फ़ील्ड
valid_for string

ValidFor, वह अवधि होती है जिसके लिए यह स्ट्रीम मान्य होती है. इसे "00h00m00s" फ़ॉर्मैट में दिखाया जाता है.
valid_until string

ValidUntil, वह तारीख और समय है जब तक यह स्ट्रीम मान्य है.
ad_pods [object(AdPod)]

इंसर्शन ऑर्डर के हिसाब से क्रम में लगाए गए विज्ञापन पॉड की सूची.
stream_id string

StreamID, दर्शक की मौजूदा स्ट्रीम का यूनीक आइडेंटिफ़ायर है.
media_verification_url string

MediaVerificationURL, यूआरएल का वह प्रीफ़िक्स है जिसका इस्तेमाल विज्ञापन के मीडिया की पुष्टि करने के लिए किया जाता है. इसके बारे में यहां बताया गया है. क्लाइंट साइड पर बीकन भेजने वाली स्ट्रीम के लिए मौजूद नहीं है.
pod_metadata object(PodMetadata)

PodMetadata में, डिवाइस पर पॉड को रेंडर करने और पुष्टि करने की प्रोसेस को ट्रिगर करने के लिए ज़रूरी अतिरिक्त जानकारी होती है. डाइनैमिक ऐड इंसर्शन लीनियर एपीआई के दस्तावेज़ में बताया गया है. यह सिर्फ़ क्लाइंट-साइड बीकनिंग स्ट्रीम के लिए शामिल किया जाता है.
metadata_url string

MetadataURL, विज्ञापन पॉड के मेटाडेटा का अनुरोध करने के लिए इस्तेमाल किया जाने वाला मेटाडेटा यूआरएल है.

AdPod

AdPod, विज्ञापन दिखाने के लिए तैयार विज्ञापन ब्रेक को दिखाता है.
JSON के काेड में दिखाना
{
  "manifest_uris": map[string, string],
  "multivariant_uri": string,
  "mpd_uri": string,
  "manifests": map[string, string],
  "multivariant_manifest": string,
  "mpd_manifest": string,
  "asset_list_uri": string,
  "start": number,
  "duration": number,
  "type": string,
  "midroll_index": number,
}
फ़ील्ड
manifest_uris string

ManifestURIs, HLS कॉन्टेंट के लिए एन्कोडिंग प्रोफ़ाइल के नाम से लेकर HLS के अलग-अलग वर्शन के manifest_uris तक का मैप होता है.
multivariant_uri string

MultivariantURI, HLS कॉन्टेंट के लिए मल्टीवेरिएंट मेनिफ़ेस्ट का यूआरआई है.
mpd_uri string

MPDURI, DASH कॉन्टेंट के लिए MPD का यूआरआई है.
manifests string

Manifests is a map of encoding profile name to the HLS variant manifest. यह फ़ील्ड सिर्फ़ तब दिखता है, जब स्ट्रीम के लिए enable_inline_manifests को 'सही है' पर सेट किया गया हो.
multivariant_manifest string

MultivariantManifest, HLS कॉन्टेंट के लिए मल्टीवेरिएंट मेनिफ़ेस्ट है. यह फ़ील्ड सिर्फ़ तब दिखता है, जब स्ट्रीम के लिए enable_inline_manifests को 'सही है' पर सेट किया गया हो.
mpd_manifest string

MPDManifest, DASH कॉन्टेंट के लिए MPD मेनिफ़ेस्ट है. यह फ़ील्ड सिर्फ़ तब दिखता है, जब स्ट्रीम के लिए enable_inline_manifests को 'सही है' पर सेट किया गया हो.
asset_list_uri string

AssetListURI, HLS कॉन्टेंट के लिए HLS इंटरस्टीशियल ऐसेट-लिस्ट का यूआरआई है. यह फ़ील्ड सिर्फ़ तब भरा जाता है, जब स्ट्रीम में ऐसेट-लिस्ट इंटरस्टीशियल चालू हों.
start number

ऐसेट टाइमलाइन में विज्ञापन पॉड के शुरू होने का समय. इसमें पहले के विज्ञापन पॉड शामिल नहीं होते. यह समय फ़्लोटिंग पॉइंट सेकंड में होता है.
duration number

फ़्लोटिंग पॉइंट सेकंड में विज्ञापन पॉड की अवधि.
type string

विज्ञापन के लिए ब्रेक का टाइप.
midroll_index number

यह स्ट्रीम में मौजूद मिडरोल का इंडेक्स होता है. यह VMAP ब्रेक आईडी पर आधारित होता है. प्रीरोल और पोस्टरोल के लिए शामिल नहीं किया गया.

AdPodDecisionOptions

AdPodDecisionOptions, स्ट्रीम के लिए अतिरिक्त विकल्पों को दिखाता है.
JSON के काेड में दिखाना
{
  "dash_profile": string,
  "match_options": object(MatchOpts),
  "data_sharing_policy_code": string,
  "sam_id": string,
  "session_title": string,
  "dash_inband_event_stream": boolean,
  "distinct_ad_profiles": boolean,
}
फ़ील्ड
dash_profile string

इस्तेमाल की जाने वाली MPEG-DASH प्रोफ़ाइल, 'लाइव' या 'मांग पर'.
match_options object(MatchOpts)

data_sharing_policy_code string

इस कुकी की मदद से पब्लिशर, नेटवर्क की डिफ़ॉल्ट डेटा शेयरिंग नीति को बदल सकते हैं.
sam_id string

sam_id, सेशन के लिए SAM डीबग कुंजी है. यह ज़रूरी नहीं है.
session_title string

session_title, स्ट्रीम के लिए SAM सेशन का टाइटल है. यह वैकल्पिक है.
dash_inband_event_stream boolean

dash_inband_event_stream से पता चलता है कि DAI, ID3 मैसेज को EventStream एलिमेंट (इन-मैनिफ़ेस्ट) के बजाय, InbandEventStream एलिमेंट का इस्तेमाल करके इनबैंड इवेंट (इन-मीडिया) के तौर पर डालता है.
distinct_ad_profiles boolean

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

स्ट्रीम

स्ट्रीम का इस्तेमाल, JSON फ़ॉर्मैट में नई बनाई गई स्ट्रीम के सभी संसाधनों की सूची को रेंडर करने के लिए किया जाता है .
JSON के काेड में दिखाना
{
  "stream_id": string,
  "valid_for": string,
  "valid_until": string,
  "media_verification_url": string,
}
फ़ील्ड
stream_id string

स्ट्रीम आइडेंटिफ़ायर.
valid_for string

स्ट्रीम की अवधि, "00h00m00s" फ़ॉर्मैट में दी गई है.
valid_until string

आरएफ़सी 3339 फ़ॉर्मैट में, वह तारीख जब तक स्ट्रीम मान्य है.
media_verification_url 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

पुष्टि करने के लिए बूटस्ट्रैप कोड को पास की गई ओपेक स्ट्रिंग.

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> नोड की वैल्यू.