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

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

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

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

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

वीओडी स्ट्रीम के लिए डीएआई एपीआई लागू करना

DAI API, एचएलएस और डैश दोनों प्रोटोकॉल का इस्तेमाल करके वीओडी स्ट्रीम के साथ काम करता है. तरीका इस गाइड में बताई गई बातें दोनों प्रोटोकॉल पर लागू होती हैं.

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

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. प्लेयर से हर बार अपडेट करें या सेट की गई फ़्रीक्वेंसी के हिसाब से अपडेट करें (सुझाया गया 500ms), इसके ज़रिए हाल ही में सुने गए इवेंट के लिए मीडिया इवेंट सूची देखें इवेंट के टाइमस्टैंप की तुलना प्लेहेड से की जा सकती है.
   3. जिन मीडिया इवेंट की आपने पुष्टि की है कि वे चल चुके हैं, उनके लिए प्लेबैक को इस हिसाब से ट्रैक करें मीडिया वेरिफ़िकेशन एंडपॉइंट में मीडिया आईडी जोड़कर और जीईटी अनुरोध.

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

   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 जानकारी दी गई, जैसे लाइव कॉन्टेंट देखने में आपकी मदद कर सकता है.

अन्य संसाधन

• एपीआई के बारे में जानकारी दस्तावेज़
• सामान्य सैंपल
• IMA SDK के दस्तावेज़
• डीएआई लेयर के लागू होने के टाइप की तुलना