DAI Ad Break API के बारे में जानकारी

डाइनैमिक विज्ञापन इंसर्शन (डीएआई) के लिए विज्ञापन ब्रेक एपीआई की मदद से, लाइव स्ट्रीम में आने वाले विज्ञापन ब्रेक की टाइमिंग और विज्ञापन टारगेटिंग डेटा को बनाया और मैनेज किया जा सकता है.

डीएआई Ad Break API की मदद से, ये काम किए जा सकते हैं:

  • ज़्यादा ट्रैफ़िक के दौरान, विज्ञापन दिखाने की दर बढ़ाएं: डीएआई सेवाओं को ज़्यादा समय दें, ताकि वे आपके लाइव इवेंट के लिए सबसे ज़्यादा रेवेन्यू देने वाले विज्ञापन चुन सकें. हमारा सुझाव है कि अगर आपकी लाइव स्ट्रीम में एक साथ कई लोग शामिल होते हैं, डाइनैमिक विज्ञापन टैग इस्तेमाल किए जाते हैं या विज्ञापन दिखने में ज़्यादा समय लगता है, तो DAI Ad Break API का इस्तेमाल करें.
  • विज्ञापन ब्रेक को पूरी तरह से कंट्रोल करें: विज्ञापन ब्रेक को पहले से बनाएं, अपडेट करें, और मिटाएं. इससे, मेनिफ़ेस्ट में विज्ञापन सिग्नल देने की तुलना में ज़्यादा आसानी होती है. साथ ही, पॉड के तौर पर विज्ञापन दिखाने के लिए, तुरंत फ़ैसला लेने की सुविधा की तुलना में ज़्यादा फ़िल रेट मिलता है.
  • दर्शकों को बिना रुकावट के वीडियो देखने का अनुभव देना: सटीक ब्रेक की जानकारी देकर, विज्ञापन से जुड़ी प्लेबैक की गड़बड़ियों को कम करें. जैसे, विज्ञापनों के पॉड में कम या ज़्यादा विज्ञापन दिखाना.

इस गाइड में, DAI Ad Break API के तरीकों के बारे में बताया गया है. साथ ही, इसमें DAI Full Service और Pod Serving के फ़्लो के लिए, विज्ञापन के लिए ब्रेक की लाइफ़साइकल के बारे में जानकारी दी गई है.

DAI विज्ञापन के लिए ब्रेक API के तरीकों के बारे में जानें

एपीआई, AdBreak रिसॉर्स मैनेज करने के लिए, इन स्टैंडर्ड तरीकों का इस्तेमाल करता है:

  • Create: यह LiveStreamEvent इकाई के लिए नई AdBreak इकाई तय करता है. विज्ञापन के लिए ब्रेक शुरू होने से 60 सेकंड पहले, विज्ञापन दिखाने का फ़ैसला लेने के लिए, expectedStartTime प्रॉपर्टी को सेट करें. हालांकि, ऐसा करना ज़रूरी नहीं है.
  • Get: यह किसी AdBreak इकाई की जानकारी वापस लाता है. इसमें विज्ञापन के लिए ब्रेक की स्थिति और समय का मेटाडेटा शामिल होता है.
  • List: यह फ़ंक्शन, किसी LiveStreamEvent इकाई के लिए, एपीआई की मदद से पहले बनाई गई AdBreak इकाइयों की सूची दिखाता है. यह सूची, उल्टे क्रम में होती है. ध्यान दें कि एपीआई, सिर्फ़ कॉन्टेंट स्ट्रीम मेनिफ़ेस्ट में तय किए गए विज्ञापन ब्रेक नहीं दिखाता.
  • Update: विज्ञापन का फ़ैसला लेने की प्रोसेस शुरू होने से पहले, यह मौजूदा AdBreak इकाई में बदलाव करता है.
  • Delete: इससे पहले से बनाई गई AdBreak इकाई के लिए, विज्ञापन दिखाने का फ़ैसला रद्द हो जाता है.

विज्ञापन ब्रेक के लाइफ़साइकल के बारे में जानकारी

AdBreak इकाई की ये स्थितियां होती हैं:

  • BREAK_STATE_UNSPECIFIED: डिफ़ॉल्ट स्थिति.
  • BREAK_STATE_SCHEDULED: विज्ञापन के लिए ब्रेक को शेड्यूल कर दिया गया है और विज्ञापन दिखाने का फ़ैसला लेने के लिए तैयार है.
  • BREAK_STATE_DECISIONED: DAI सेवाओं ने विज्ञापन ब्रेक के लिए विज्ञापन चुनने की प्रोसेस शुरू कर दी है. विज्ञापन के लिए ब्रेक में बदलाव नहीं किया जा सकता. हालांकि, विज्ञापन के लिए ब्रेक को रद्द किया जा सकता है. इससे विज्ञापन सर्वर पर बुरा असर पड़ सकता है.
  • BREAK_STATE_COMPLETE: विज्ञापन के लिए ब्रेक को उपयोगकर्ताओं को दिखाया गया है.

इस डायग्राम में, AdBreak इकाई की टाइमलाइन दिखाई गई है. इसमें इकाई के बनने से लेकर उसके पूरा होने तक की जानकारी दी गई है.

विज्ञापन ब्रेक की इकाई को बनाने से लेकर पूरा होने तक की प्रोसेस.

विज्ञापन के लिए ब्रेक शुरू होने से 1 से 300 मिनट पहले, AdBreak इकाई बनाई जा सकती है.

  • विज्ञापन ब्रेक के शुरू होने के अनुमानित समय से एक मिनट पहले, विज्ञापन ब्रेक न बनाएं. ऐसा इसलिए, क्योंकि Google DAI के पास विज्ञापन से जुड़े फ़ैसले लेने के लिए, शायद ही इतना समय हो. इससे विज्ञापन फ़िल रेट कम हो सकता है.
  • विज्ञापन ब्रेक के शुरू होने के अनुमानित समय से छह घंटे पहले, विज्ञापन ब्रेक न बनाएं. ऐसा इसलिए, क्योंकि विज्ञापन सर्वर, अनुरोध किए गए विज्ञापनों को अमान्य कर सकते हैं.

यहां दिए गए सेक्शन में, डीएआई की पूरी सेवा और पॉड सर्व करने के फ़्लो में विज्ञापन के लिए ब्रेक की स्थिति में होने वाले बदलावों के बारे में बताया गया है.

फ़ुल-सर्विस DAI के फ़्लो के बारे में जानकारी

Google की फ़ुल-सर्विस डीएआई सुविधा, कॉन्टेंट मेनिफ़ेस्ट और विज्ञापनों के पॉड, दोनों को मैनेज करती है.

विज्ञापन को कस्टम तरीके से टारगेट करने के लिए, DAI Ad Break API का इस्तेमाल करें. इससे कॉन्टेंट की लाइवस्ट्रीम मेनिफ़ेस्ट में, विज्ञापन मार्कर से पहले AdBreak इकाई बनाई जा सकती है.

  • इस लीड समय की मदद से, Google की DAI सेवाएं विज्ञापन दिखाने का फ़ैसला लेने के लिए, आपके AdBreak डेटा का इस्तेमाल कर सकती हैं.
  • जब Google DAI को मेनिफ़ेस्ट विज्ञापन मार्कर का पता चलता है, तो सिस्टम AdBreak इकाई के डेटा के साथ विज्ञापन के फ़ैसलों का इस्तेमाल करता है. साथ ही, इकाई की स्थिति को BREAK_STATE_COMPLETE में बदल देता है.

फ़ुल-सर्विस डीएआई फ़्लो में, विज्ञापन के लिए ब्रेक की इकाई को बनाने से लेकर पूरा करने तक की प्रोसेस.

पॉड दिखाने के फ़्लो के बारे में जानकारी

इस फ़्लो में, आपको कॉन्टेंट की लाइव स्ट्रीम के मेनिफ़ेस्ट को मैनेज करना होता है. इसके अलावा, मेनिफ़ेस्ट में विज्ञापन मार्कर का पता लगाने के लिए, तीसरे पक्ष की मेनिफ़ेस्ट में हेर-फेर करने वाली सेवा का इस्तेमाल किया जा सकता है.

विज्ञापन ब्रेक के शुरू होने के अनुमानित समय से पहले, DAI Ad Break API को कॉल करें. इससे आपको विज्ञापन पॉड सेगमेंट या विज्ञापन मेनिफ़ेस्ट का अनुरोध करने से पहले, AdBreak इकाई बनाने में मदद मिलेगी.

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

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

विज्ञापन ब्रेक की इकाई की पूरी स्थिति.

पहला अनुरोध करना

एपीआई का ऐक्सेस सेट अप करने और पहला अनुरोध करने के लिए, DAI Ad Break API का इस्तेमाल करना लेख पढ़ें.