Google Dynamic Ad Insertion (DAI) Pod serving API.
Pod Serving API, अडैप्टिव बिटरेट वाले वीडियो विज्ञापन पॉड का ऐक्सेस देता है. इन्हें इस तरह से तैयार किया जाता है कि इन्हें सीधे तौर पर, उपयोगकर्ता के सामने आने वाली HLS या MPEG DASH मीडिया प्लेलिस्ट में स्टिच किया जा सके.
यह एपीआई, ऐडवांस पब्लिशर और वीडियो टेक्नोलॉजी पार्टनर के लिए है. इस एपीआई का बड़े पैमाने पर इस्तेमाल करने के लिए, मीडिया दिखाने से जुड़े बेहतर वर्कफ़्लो को डिज़ाइन और लागू करना ज़रूरी है. यह इस दस्तावेज़ के दायरे से बाहर है.
ज़रूरी शर्तें
DAI Podserving API के ज़रिए लाइवस्ट्रीम को प्रोसेस करने से पहले, आपको Google Ad Manager यूज़र इंटरफ़ेस (यूआई) या लाइव-इवेंट एपीआई का इस्तेमाल करके, लाइवस्ट्रीम इवेंट बनाना होगा.
घटक
पॉड सर्विंग एपीआई को लागू करने के लिए, तीन कॉम्पोनेंट की ज़रूरत होती है: Google Ad Manager, क्लाइंट वीडियो प्लेयर, और मेनिफ़ेस्ट में बदलाव करने वाला सर्वर.
Ad Manager
Ad Manager, उपयोगकर्ता को विज्ञापन दिखाने के लिए ज़िम्मेदार है. इसे Ad Manager SDK या इसके वेब इंटरफ़ेस के ज़रिए मैनेज किया जा सकता है. इस सेवा की ये ज़िम्मेदारियां हैं:
- क्लाइंट वीडियो प्लेयर से स्ट्रीम के अनुरोध पाना, विज्ञापनों के बारे में फ़ैसला लेना, और आपके कॉन्टेंट एन्कोडिंग प्रोफ़ाइलों से मेल खाने वाले रेंडिशन उपलब्ध कराना
- क्लाइंट वीडियो प्लेयर से मिले विज्ञापन सेगमेंट के अनुरोधों का जवाब देना और उपयोगकर्ता को विज्ञापन पॉड का सही हिस्सा उपलब्ध कराना
- क्लाइंट के वीडियो प्लेयर से ट्रैकिंग पिंग पाना और उन्हें प्रोसेस करना
क्लाइंट का वीडियो प्लेयर
क्लाइंट वीडियो प्लेयर, वह ऐप्लिकेशन या वेबसाइट होती है जिसका इस्तेमाल क्लाइंट, वीडियो स्ट्रीम चलाने के लिए करते हैं. खिलाड़ी की ये ज़िम्मेदारियां होती हैं:
- Ad Manager से स्ट्रीम संसाधन को शुरू करना और स्ट्रीम ऑब्जेक्ट पाना. यह ऑब्जेक्ट, किसी खास लाइव स्ट्रीम इवेंट के एक प्लेबैक सेशन को दिखाता है.
- मेनिफ़ेस्ट में बदलाव करने वाले सर्वर से स्ट्रीम मेनिफ़ेस्ट का अनुरोध करना, जिससे वीडियो चलना शुरू होता है
- Ad Manager से विज्ञापन पॉड के मेटाडेटा को समय-समय पर पोल करना. इस मेटाडेटा में, स्ट्रीम के विज्ञापन सेगमेंट में एम्बेड किए गए विज्ञापन इवेंट की जानकारी होती है
- यह कुकी, प्लेयर की ओर से जनरेट किए गए टाइम किए गए मेटाडेटा इवेंट को सुनती है. इनमें विज्ञापन मीडिया आईडी शामिल होते हैं. इन इवेंट का पता चलने पर, प्लेयर इन्हें Ad Manager को भेजता है. इससे यह पुष्टि की जाती है कि विज्ञापन इवेंट सही तरीके से हुए हैं.
क्लाइंट वीडियो प्लेयर को सही तरीके से लागू करने के बारे में ज़्यादा जानने के लिए, अपने प्लैटफ़ॉर्म के लिए पॉड दिखाने से जुड़ी गाइड देखें:
कस्टम लागू करने के लिए, DAI API के लिए पॉड सर्व करने वाले क्लाइंट की गाइड देखें.
मेनिफ़ेस्ट में बदलाव करने वाला सर्वर
मैनिफ़ेस्ट में बदलाव करने वाला सर्वर, स्ट्रीम मैनिफ़ेस्ट को होस्ट करने के लिए ज़िम्मेदार होता है. यह मैनिफ़ेस्ट, क्लाइंट वीडियो प्लेयर को उपलब्ध कराया जाता है. सर्वर की ये ज़िम्मेदारियां हैं:
- यह कुकी, क्लाइंट वीडियो प्लेयर को मेनिफ़ेस्ट डिलीवर करने की प्रोसेस को मैनेज करती है
- विज्ञापन सेगमेंट से जानकारी भरने के लिए, Ad Manager से अवधि का टेंप्लेट का अनुरोध करना (सिर्फ़ MPEG DASH स्ट्रीम के लिए).
- विज्ञापन के लिए ब्रेक के दौरान, Ad Manager पर होस्ट किए गए विज्ञापन सेगमेंट के यूआरएल को वीडियो स्ट्रीम मेनिफ़ेस्ट (एचएलएस के लिए) या विज्ञापन अवधि (MPEG DASH के लिए) में डालना.
- क्लाइंट के वीडियो प्लेयर को बदला गया मेनिफ़ेस्ट दिखाया जा रहा है.
कस्टम मेनिफ़ेस्ट मैनिपुलेटर सर्वर को लागू करने के बारे में ज़्यादा जानने के लिए, मेनिफ़ेस्ट मैनिपुलेशन गाइड देखें.
शब्दावली
- लाइव स्ट्रीम इवेंट: यह एक ऐसा इवेंट होता है जो लाइव स्ट्रीम के लिए कॉन्फ़िगरेशन का अहम डेटा सेव करता है. जैसे, एन्कोडिंग प्रोफ़ाइलें. लाइव स्ट्रीम इवेंट, Ad Manager का इस्तेमाल करके बनाए जाते हैं.
- स्ट्रीम ऑब्जेक्ट: यह एक ऐसा ऑब्जेक्ट होता है जो किसी वीडियो ऐसेट के एक बार चलाए जाने वाले सेशन को दिखाता है. खास प्रॉपर्टी में स्ट्रीम आईडी और मीडिया की पुष्टि करने वाला यूआरएल शामिल है.
- विज्ञापनों का पॉड: विज्ञापन के लिए ब्रेक के दौरान दिखाए जाने वाले वीडियो विज्ञापनों का ग्रुप
- विज्ञापन सेगमेंट: विज्ञापन ब्रेक के लिए मीडिया सेगमेंट फ़ाइलें
- विज्ञापन पॉड का मेटाडेटा: विज्ञापन ब्रेक का मेटाडेटा. इसका इस्तेमाल, क्लाइंट पर विज्ञापन यूज़र इंटरफ़ेस (यूआई) को रेंडर करने के लिए किया जाता है. उदाहरण के लिए, विज्ञापन के दौरान 'छिपाएं' और 'ढूंढें' बटन
- विज्ञापन मीडिया आईडी: विज्ञापन सेगमेंट फ़ाइलों में ID3 टैग के तौर पर एन्कोड किया गया मेटाडेटा. इस मेटाडेटा का इस्तेमाल यह पता लगाने के लिए किया जाता है कि वीडियो चलाने के दौरान, विज्ञापन से जुड़े कुछ इवेंट कब हुए. जैसे, विज्ञापन कब शुरू हुआ या बीच में कब आया.