वीओडी स्ट्रीम के लिए मेनिफ़ेस्ट मैन्युफ़ैक्चरर

पॉड सर्विंग एपीआई, ऐसे अडैप्टिव-बिटरेट वीडियो विज्ञापन पॉड का ऐक्सेस देता है जिन्हें इस तरह से तैयार किया गया है कि उन्हें सीधे तौर पर उपयोगकर्ता के सामने दिखने वाली एचएलएस या MPEG-DASH मीडिया प्लेलिस्ट में जोड़ा जा सकता है.

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

स्ट्रीम मेनिफ़ेस्ट के अनुरोध पाना

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

सही कॉन्टेंट स्ट्रीम की पहचान करने के लिए, आपको कुछ और जानकारी भी इकट्ठा करनी होगी. जैसे, Content ID.

मेनिफ़ेस्ट के अनुरोध वाले एंडपॉइंट का उदाहरण

GET /api/stream_id/{stream_id}/video/{content_id}.{format}
Host: {your_domain}

कॉन्टेंट स्ट्रीम वापस पाना

विज्ञापनों के साथ जोड़ने के लिए कॉन्टेंट स्ट्रीम चुनने के लिए, मेनिफ़ेस्ट अनुरोध से इकट्ठा किए गए Content ID का इस्तेमाल करें.

विज्ञापन पॉड मेनिफ़ेस्ट का अनुरोध करना

Ad Manager से विज्ञापनों का अनुरोध करने के लिए, आपके सर्वर को विज्ञापन वाले पॉड के एंडपॉइंट पर एक पोस्ट अनुरोध करना होगा. इसमें, अनुरोध की गई एन्कोडिंग प्रोफ़ाइलें और विज्ञापन टैग शामिल होने चाहिए. इस अनुरोध में, पहले चरण में इकट्ठा किया गया स्ट्रीम आईडी भी शामिल होता है.

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

POST /ondemand/pods/api/v1/network/{network_code}/streams/{stream_id}/adpods
Host: dai.google.com
Content-Type: application/json

JSON बॉडी

जवाब

अनुरोध का उदाहरण (cURL)

curl -X POST \
     -d '@request-body.json' \
     -H 'Content-Type: application/json' \
  https://dai.google.com/ondemand/pods/api/v1/network/21775744923/streams/6e69425c-0ac5-43ef-b070-c5143ba68541:CHS/adpods

अनुरोध के मुख्य हिस्से का उदाहरण

यह ऊपर दिए गए cURL कॉल में रेफ़र किए गए request-body.json का कॉन्टेंट है.

{
  "encoding_profiles": [
   {
     "profile_name": "1080p",
     "type": "media",
     "container_type": "mpeg2ts",
     "video_settings": {
       "codec": "avc1.4d000c",
       "bitrate": 5000000,
       "frames_per_second": 30.0,
       "resolution": {
         "width": 1920,
         "height": 1080
       }
     },
     "audio_settings": {
       "codec": "mp4a.40.5",
       "bitrate": 300000,
       "channels": 2,
       "sample_rate": 48000
     }
   },
   {
     "profile_name": "360p",
     "type": "media",
     "container_type": "mpeg2ts",
     "video_settings": {
       "codec": "avc1.4d000d",
       "bitrate": 1000000,
       "frames_per_second": 30.0,
       "resolution": {
         "width": 640,
         "height": 360
       }
     },
     "audio_settings": {
       "codec": "mp4a.40.5",
       "bitrate": 64000,
       "channels": 2,
       "sample_rate": 48000
     }
   },
   {
     "profile_name": "subtitles-webvtt",
     "type": "subtitles",
     "subtitle_settings": {
       "format": "webvtt"
     }
   }
 ],
 "ad_tag": "https://pubads.g.doubleclick.net/gampad/ads?...",
 "manifest_type": "hls"
}

जवाब का उदाहरण

{
  "valid_for": "8h0m0s",
  "valid_until": "2023-03-24T08:30:26.839717986-07:00",
  "ad_pods": [
    {
      "manifest_urls":{
        "1080p": "https://{...}/pod/0/profile/1080p.m3u8",
        "360p": "https://{...}/pod/0/profile.m3u8",
        "subtitles-webvtt": "https://{...}/pod/0/profile/subtitles-en.vtt"
      },
      "type": "pre",
      "duration": 10.0
    },
    {
      "manifest_urls":{
        "1080p": "https://{...}/pod/1/profile/1080p.m3u8",
        "360p": "https://{...}/pod/1/profile.m3u8",
        "subtitles-webvtt": "https://{...}/pod/1/profile/subtitles-en.vtt"
      },
      "type": "mid",
      "start": 15.0,
      "duration": 15.0,
      "midroll_index": 1
    },
    {
      "manifest_urls":{
        ]"1080p": "https://{...}/pod/2/profile/1080p.m3u8",
        "360p": "https://{...}/pod/2/profile.m3u8",
        "subtitles-webvtt": "https://{...}/pod/0/profile/subtitles-en.vtt""
      },
      "type": "post",
      "duration": 10.0
    }
  ]
}

कॉन्टेंट में विज्ञापन पॉड जोड़ना

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

एचएलएस स्ट्रीम

अगर किसी स्ट्रीम को एचएलएस फ़ॉर्मैट में स्टिच किया जा रहा है, तो आपकी कॉन्टेंट स्ट्रीम, अलग-अलग स्ट्रीम मेनिफ़ेस्ट के लिंक की मल्टीवैरिएंट प्लेलिस्ट होगी. हर एन्कोडिंग प्रोफ़ाइल के लिए एक लिंक होगा. आपके विज्ञापन पॉड को इन सभी वैरिएंट मेनिफ़ेस्ट में डालना होगा. ऐसा करने का एक तरीका यह है कि सभी वैरिएंट मेनिफ़ेस्ट तैयार किए जाएं और उन्हें होस्ट करने के लिए कॉन्टेंट डिलीवरी नेटवर्क (सीडीएन) को भेजा जाए. मल्टीवैरिएंट वाली फ़ाइनल प्लेलिस्ट, सीडीएन पर होस्ट किए गए इन मेनिफ़ेस्ट के लिंक का एक सेट होती है.

एन्कोडिंग प्रोफ़ाइलों पर बार-बार जाना

हर एन्कोडिंग प्रोफ़ाइल के लिए, Ad Manager के रिस्पॉन्स से उससे जुड़े सभी विज्ञापन पॉड मेनिफ़ेस्ट इकट्ठा करें. साथ ही, उनके शुरू होने के समय की जानकारी भी इकट्ठा करें. प्री-रोल विज्ञापन के लिए, शुरू होने का समय 0 पर सेट करें. पोस्ट-रोल के लिए, कॉन्टेंट की अवधि को विज्ञापन पॉड के शुरू होने के समय के तौर पर इस्तेमाल करें. मल्टीवैरिएंट प्लेलिस्ट में उस वैरिएंट स्ट्रीम की पहचान करें जो हर कोड में बदलने की प्रोफ़ाइल की ऑडियो और वीडियो सेटिंग से मेल खाती हो.

विज्ञापन पॉड कलेक्शन का उदाहरण

"ad_pods": [
    {
      "manifest_urls":{
        "1080p": "https://{...}/pod/0/profile/1080p.m3u8",
        "360p": "https://{...}/pod/0/profile/360p.m3u8",
        "subtitles-en": "https://{...}/pod/0/profile/subitles-en.vtt"
      },
      "type": "pre",
      "duration": 10.0
    },
    {
      "manifest_urls":{
        "1080p": "https://{...}/pod/1/profile/1080p.m3u8",
        "360p": "https://{...}/pod/1/profile/360p.m3u8",
        "subtitles-en": "https://{...}/pod/1/profile/subitles-en.vtt"
      },
      "type": "mid",
      "start": 15.0,
      "duration": 15.0,
      "midroll_index": 1
    },
    {
      "manifest_urls":{
        "1080p": "https://{...}/pod/2/profile/1080p.m3u8",
        "360p": "https://{...}/pod/2/profile/360p.m3u8",
        "subtitles-en": "https://{...}/pod/2/profile/subitles-en.vtt"
      },
      "type": "post",
      "duration": 10.0
    }
  ]

अलग-अलग वैरिएंट वाले कॉन्टेंट की प्लेलिस्ट का उदाहरण

#EXTM3U
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs0",LANGUAGE="en",NAME="English",AUTOSELECT=YES,DEFAULT=YES,URI="https://{...}/subitles-en.vtt"
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,CODECS="avc1.4d000c,mp4a.40.5"
https://{...}/1080p.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1000000,RESOLUTION=640x360,CODECS="avc1.4d000d,mp4a.40.5"
https://{...}/360p.m3u8

इकट्ठा किए गए वैरिएंट डेटा का उदाहरण

Encoding profile: "1080p"
Profile settings: {...}
Content manifest: https://{...}/1080p.m3u8
Ad pods (start time -> manifest):
    0 -> https://{...}/pod/0/profile/1080p.m3u8
   15 -> https://{...}/pod/1/profile/1080p.m3u8
  600 -> https://{...}/pod/2/profile/1080p.m3u8

हर वैरिएंट मेनिफ़ेस्ट में विज्ञापन डालना

हर वैरिएंट स्ट्रीम के लिए, कॉन्टेंट मेनिफ़ेस्ट के सेगमेंट देखें. साथ ही, कॉन्टेंट के बीत चुके समय को ध्यान में रखें. विज्ञापन पॉड की शुरुआती पोज़िशन पर पहुंचने पर, विज्ञापन पॉड के मेनिफ़ेस्ट से सेगमेंट की सूची निकालें. इसके बाद, सेगमेंट की सूची को दो #EXT-X-DISCONTINUITY टैग में रैप करें और सूची को कॉन्टेंट मेनिफ़ेस्ट की मौजूदा जगह पर डालें. जब तक सभी विज्ञापन पॉड और वैरिएंट स्ट्रीम प्रोसेस नहीं हो जातीं, तब तक यह प्रोसेस जारी रखें.

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

अगर आपका कॉन्टेंट मेनिफ़ेस्ट एन्क्रिप्ट (सुरक्षित) किया गया है, तो आपको मौजूदा विज्ञापन पॉड शुरू होने से पहले, एन्क्रिप्शन की आखिरी कुंजी को #EXT-X-KEY टैग में सेव करना होगा. इसके बाद, आपको हर विज्ञापन पॉड के पहले सेगमेंट से पहले, एन्क्रिप्शन हटाने के लिए टैग #EXT-X-KEY:METHOD=NONE जोड़ना होगा. आखिर में, कॉन्टेंट को एन्क्रिप्ट करने की सुविधा को वापस लाने के लिए, आपको हर विज्ञापन पॉड के बाद कॉन्टेंट के पहले सेगमेंट से पहले, सेव किए गए #EXT-X-KEY टैग की कॉपी जोड़नी होगी.

इकट्ठा किए गए वैरिएंट डेटा का उदाहरण

Encoding profile: "1080p"
Content manifest: https://{...}/1080p.m3u8
Ad pods (start time -> manifest):
    0 -> https://dai.google.com/{...}pod/0/profile/1080p.m3u8
   15 -> https://dai.google.com/{...}pod/1/profile/1080p.m3u8
  600 -> https://dai.google.com/{...}pod/2/profile/1080p.m3u8

कॉन्टेंट मेनिफ़ेस्ट का उदाहरण

यह इकट्ठा किए गए वैरिएंट डेटा में मौजूद https://{...}/1080p.m3u8 मेनिफ़ेस्ट का कॉन्टेंट है.

#EXTM3U
{...}
#EXTINF:5.000,
https://{...}/1080p/content-segment-0.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-1.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-2.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-3.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-4.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-5.ts
{...}

विज्ञापन पॉड मेनिफ़ेस्ट का उदाहरण

यह इकट्ठा किए गए वैरिएंट डेटा में मौजूद, https://dai.google.com/{...}/pod/1/profile/1080p.m3u8 मेनिफ़ेस्ट का कॉन्टेंट है.

#EXTM3U
{...}
#EXTINF:5.000,
https://dai.google.com/{...}/0.ts
#EXTINF:5.000,
https://dai.google.com/{...}/1.ts
#EXTINF:5.000,
https://dai.google.com/{...}/2.ts

स्टिच किए गए वैरिएंट मेनिफ़ेस्ट का उदाहरण

यह स्टिच किया गया वैरिएंट मेनिफ़ेस्ट होगा, जिसे सीडीएन को पास किया जाएगा और https://cdn.{...}/{userid}/1080p.m3u8 पर होस्ट किया जाएगा.

#EXTM3U
{...}
#EXTINF:5.000,
https://{...}/1080p/content-segment-0.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-1.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-2.ts
#EXT-X-DISCONTINUITY
#EXTINF:5.000,
https://dai.google.com/{...}/0.ts
#EXTINF:5.000,
https://dai.google.com/{...}/1.ts
#EXTINF:5.000,
https://dai.google.com/{...}/2.ts
#EXT-X-DISCONTINUITY
#EXTINF:5.000,
https://{...}/1080p/content-segment-3.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-4.ts
#EXTINF:5.000,
https://{...}/1080p/content-segment-5.ts
{...}

मल्टीवैरिएंट प्लेलिस्ट बनाना

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

एक से ज़्यादा वैरिएंट वाली फ़ाइनल प्लेलिस्ट का उदाहरण

#EXTM3U
#EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs0",LANGUAGE="en",NAME="English",AUTOSELECT=YES,DEFAULT=YES,URI="https://cdn.{...}-subitles-en.vtt"
#EXT-X-STREAM-INF:BANDWIDTH=5000000,RESOLUTION=1920x1080,CODECS="avc1.4d000c,mp4a.40.5"
https://cdn.{...}/{userid}/1080p.m3u8
#EXT-X-STREAM-INF:BANDWIDTH=1000000,RESOLUTION=640x360,CODECS="avc1.4d000d,mp4a.40.5"
https://cdn.{...}/{userid}/360p.m3u8

MPEG DASH स्ट्रीम

अगर किसी स्ट्रीम को MPEG DASH फ़ॉर्मैट में स्टिच किया जा रहा है, तो आपको सिर्फ़ एक फ़ाइल बनानी होगी. इससे, HLS की तुलना में DASH स्ट्रीम को आसानी से स्टिच किया जा सकता है.

सही तरीके से तैयार की गई MPEG DASH मीडिया प्रज़ेंटेशन डिस्क्रिप्शन (एमपीडी) फ़ाइल में कई पीरियड होने चाहिए. हर पीरियड में कई रिप्रज़ेंटेशन होने चाहिए. हर प्रतिनिधित्व, कोड में बदलने की आपकी किसी प्रोफ़ाइल से मेल खाना चाहिए. Ad Manager से मिलने वाला हर विज्ञापन पॉड, एक एमपीडी फ़ाइल भी होता है. इसमें, मैच करने वाले रिप्रज़ेंटेशन के साथ पीरियड का क्रम होता है.

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

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

कॉन्टेंट एमपीडी का उदाहरण

<?xml version="1.0" encoding="UTF-8"?>
<MPD xmlns="urn:mpeg:dash:schema:mpd:2011" minBufferTime="PT1.500000S" type="static" mediaPresentationDuration="PT0H10M00.000S" profiles="urn:mpeg:dash:profile:isoff-on-demand:2011">
  <ProgramInformation moreInformationURL="http://.../info">
    <Title>Example Stream</Title>
  </ProgramInformation>
  <Period duration="PT0H0M15.000S" id="content-period-1">
    ...
  </Period>
  <Period duration="PT0H0M15.000S" id="content-period-2">
    ...
  </Period>
  <Period duration="PT0H0M15.000S" id="content-period-3">
    ...
  </Period>
  ...
</MPD>

विज्ञापन पॉड के JSON का उदाहरण

[{
  "mpd_uri": "https://{...}pod/1.mpd",
  "type": "mid",
  "start": 15.0,
  "duration": 15.0,
  "midroll_index": 1
}]

विज्ञापन पॉड एमपीडी का उदाहरण

यह ऊपर दिए गए विज्ञापन पॉड के JSON में मौजूद mpd_uri का कॉन्टेंट है.

<?xml version="1.0" encoding="UTF-8"?>
<MPD xmlns="urn:mpeg:dash:schema:mpd:2011" minBufferTime="PT1.500000S" type="static" mediaPresentationDuration="PT0H0M15.000S" profiles="urn:mpeg:dash:profile:isoff-on-demand:2011">
  <ProgramInformation moreInformationURL="http://.../info">
    <Title>Ad Pod 1</Title>
  </ProgramInformation>
  <Period duration="PT0H0M5.000S" id="ad-pod-1-period-1">
    ...
  </Period>
  <Period duration="PT0H0M5.000S" id="ad-pod-1-period-2">
    ...
  </Period>
  <Period duration="PT0H0M5.000S" id="ad-pod-1-period-3">
    ...
  </Period>
  ...
</MPD>

स्टिच किए गए एमपीडी का उदाहरण

इसे स्ट्रीम मेनिफ़ेस्ट के शुरुआती अनुरोध के जवाब के तौर पर सबमिट करें.

<?xml version="1.0" encoding="UTF-8"?>
<MPD xmlns="urn:mpeg:dash:schema:mpd:2011" minBufferTime="PT1.500000S" type="static" mediaPresentationDuration="PT0H10M15.000S" profiles="urn:mpeg:dash:profile:isoff-on-demand:2011">
  <ProgramInformation moreInformationURL="http://.../info">
    <Title>Example Stream</Title>
  </ProgramInformation>
  <Period duration="PT0H0M15.000S" id="content-period-1">
    ...
  </Period>
  <Period duration="PT0H0M5.000S" id="ad-pod-1-period-1">
    ...
  </Period>
  <Period duration="PT0H0M5.000S" id="ad-pod-1-period-2">
    ...
  </Period>
  <Period duration="PT0H0M5.000S" id="ad-pod-1-period-3">
    ...
  </Period>
  <Period duration="PT0H0M15.000S" id="content-period-2">
    ...
  </Period>
  <Period duration="PT0H0M15.000S" id="content-period-3">
    ...
  </Period>
  ...
</MPD>

अन्य संसाधन

• IMA SDK टूल की मदद से पॉडकास्ट चलाना:
  • Android
  • HTML5
  • iOS
  • tvOS
• DAI API की मदद से पॉडकास्ट चलाना