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

Google DAI API की मदद से, ऐसे माहौल में Google DAI की सुविधा वाली स्ट्रीम लागू की जा सकती हैं जहां IMA SDK लागू नहीं किया जा सकता. हमारा सुझाव है कि आप अब भी उन प्लैटफ़ॉर्म पर IMA का इस्तेमाल करें, जहां IMA SDK काम करता है.

हम इन प्लैटफ़ॉर्म पर डीएआई एपीआई इस्तेमाल करने का सुझाव देते हैं:

  • Samsung Smart TV (Tizen)
  • LG TV
  • HbbTV
  • Xbox (JavaScript ऐप्लिकेशन)
  • KaiOS

एपीआई में, IMA डीएआई SDK की बुनियादी सुविधाएं काम करती हैं. साथ काम करने वाली या इस्तेमाल की जा सकने वाली सुविधाओं से जुड़े खास सवालों के जवाब पाने के लिए, अपने Google खाता मैनेजर से संपर्क करें.

वीओडी स्ट्रीम के लिए DAI API का इस्तेमाल करना

DAI API, HLS और DASH दोनों प्रोटोकॉल का इस्तेमाल करके, वीओडी (वीडियो ऑन डिमांड) स्ट्रीम के साथ काम करता है. इस गाइड में बताए गए चरण दोनों प्रोटोकॉल पर लागू होते हैं.

एपीआई को वीओडी स्ट्रीम के लिए अपने ऐप्लिकेशन में इंटिग्रेट करने के लिए, ये चरण पूरे करें:

  1. स्ट्रीम के एंडपॉइंट पर पोस्ट कॉल करके, स्ट्रीम का अनुरोध करें:

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

    https://dai.google.com/ondemand/v1/dash/content/2559737/vid/tos-dash/stream

  {
    key1 : "value1",
    stream_parameter1 : "value2"
  }

    जवाब का मुख्य हिस्सा:

    {
   "stream_id":"d32f8920-612a-4d46-8bc7-d73fd6c17c85",
   "total_duration":636.458,
   "content_duration":596.458,
   "valid_for":"8h0m0s",
   "valid_until":"2020-06-04T20:39:41.274707306-07:00",
   "stream_manifest":"https://dai.google.com/ondemand/dash/content/2559737/vid/tos-dash/ATL/streams/d32f8920-612a-4d46-8bc7-d73fd6c17c85/manifest.mpd",
   "media_verification_url":"https://dai.google.com/view/p/service/vod/stream/d32f8920-612a-4d46-8bc7-d73fd6c17c85/loc/ATL/network/124319096/content/2559737/vid/tos-dash/media/",
   "ad_breaks":[
      {
         "type":"pre",
         "start":0,
         "duration":10,
         "ads":[
            {
               "seq":1,
               "duration":10,
               "title":"External NCA1C1L1 Preroll",
               "description":"External NCA1C1L1 Preroll ad",
               "clickthrough_url":"https://dai.google.com/ondemand/v1/dash/content/2474148/vid/bbb-clear/location/ATL/stream/d32f8920-612a-4d46-8bc7-d73fd6c17c85/videoclick/5489259204425938365",
               "events":[
                  {
                     "time":0.1,
                     "type":"start"
                  },
                  {
                     "time":2.5,
                     "type":"firstquartile"
                  },
                  {
                     "time":4.75,
                     "type":"midpoint"
                  },
                  {
                     "time":7.5,
                     "type":"thirdquartile"
                  },
                  {
                     "time":9,
                     "type":"complete"
                  }
               ]
            }
         ]
      },
      {
         "type":"mid",
         "start":45,
         "duration":10,
         "ads":[
            {.... }
               ]
            }
         ]
      },
      {
         "type":"post",
         "start":626.458,
         "duration":10,
         "ads":[...]
      }
   ]
}

    गड़बड़ी वाला जवाब

    गड़बड़ियों के मामले में, स्टैंडर्ड एचटीटीपी गड़बड़ी कोड बिना JSON रिस्पॉन्स वाले मुख्य हिस्से के दिखाए जाते हैं.

  2. JSON के रिस्पॉन्स को पार्स करें और यहां दी गई वैल्यू सेव करें:

    • stream_id
    • stream_manifest
    • media_verification_url
    • ad_breaks

  3. मीडिया की पुष्टि करने के लिए, ID3 के इवेंट सुनें:

    1. हर मीडिया आईडी को उसके टाइमस्टैंप के साथ सेव करके, मीडिया इवेंट को सूची में सेव करें (अगर प्लेयर दिखने पर).
    2. प्लेयर से या तय की गई फ़्रीक्वेंसी (500 मि॰से॰) से हर बार अपडेट होने पर, इवेंट के टाइमस्टैंप की तुलना प्लेहेड से करें. इसके बाद, हाल ही में सुने गए इवेंट के लिए मीडिया इवेंट सूची देखें.
    3. आपने जिन मीडिया इवेंट को चलाने की पुष्टि की है उनके लिए, प्लेबैक को ट्रैक करें. इसके लिए, मीडिया वेरिफ़िकेशन एंडपॉइंट में मीडिया आईडी जोड़ें और GET अनुरोध करें.

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

    https://dai.google.com/view/p/service/linear/stream/c6bbee18-0d20-4c55-b071-efdf3a81da33:ATL/loc/ATL/network/51636543/event/0ndl1dJcRmKDUPxTRjvdog/media/

    जवाबों के उदाहरण:

    Accepted for asynchronous verification - HTTP/1.1 202 Accepted
Successful empty response - HTTP/1.1 204 No Content
Media verification not found - HTTP/1.1 404 Not Found
Media verification sent by someone else - HTTP/1.1 409 Conflict

    स्ट्रीम गतिविधि मॉनिटर में ट्रैकिंग इवेंट की पुष्टि की जा सकती है.

  4. ज़रूरी नहीं: किस तरह का इवेंट ट्रिगर हुआ है, यह जानने के लिए स्ट्रीम के ad_breaks डेटा का इस्तेमाल करके रिस्पॉन्स क्रिएट करें.

  5. सूची से मीडिया इवेंट हटाएं.

सीमाएं

अगर वेबव्यू में एपीआई का इस्तेमाल किया जा रहा है, तो टारगेटिंग के संबंध में ये सीमाएं लागू होती हैं:

  • UserAgent: उपयोगकर्ता एजेंट पैरामीटर को बुनियादी प्लैटफ़ॉर्म के बजाय, ब्राउज़र के हिसाब से वैल्यू के तौर पर पास किया जाता है.
  • rdid, idtype, is_lat: डिवाइस आईडी सही तरीके से पास नहीं होने की वजह से, ये सुविधाएं सीमित हो जाती हैं:
    • फ़्रीक्वेंसी कैपिंग
    • क्रम में चलने वाला विज्ञापन रोटेशन
    • ऑडियंस सेगमेंटेशन और टारगेटिंग

सबसे सही तरीके

वीओडी (वीडियो ऑन डिमांड) के लिए, ID3 टैग को सही इवेंट टाइप के साथ मैप करना मुश्किल होता है. इवेंट को सीधे देखने के लिए, JSON में ad_breaks की दिखाई गई जानकारी का इस्तेमाल करें, जैसा कि लाइव कॉन्टेंट में दिखता है.

अन्य संसाधन