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

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

डीएआई के लिए विज्ञापन ब्रेक एपीआई की मदद से, ये काम किए जा सकते हैं:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

कस्टम विज्ञापन टारगेटिंग के लिए, 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 का इस्तेमाल करना लेख पढ़ें.