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