SGAI का इस्तेमाल शुरू करें

सर्वर से गाइड किए गए विज्ञापन इंसर्शन (एसजीएआई) की मदद से, विज्ञापनों का पॉड मेनिफ़ेस्ट इसके लिए तैयार होता है क्लाइंट के डिवाइस पर स्टिचिंग करते हैं. अगर आपने Google में पॉड सर्विंग डीएआई को चालू किया है, तो Ad Manager नेटवर्क, आपके पास एसजीएआई का इस्तेमाल करने का ऐक्सेस है. अगर आपके पास पॉड सेवाएं देने की सुविधा नहीं है डीएआई चालू करने के लिए, अपने खाता मैनेजर से संपर्क करें.

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

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

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

ज़रूरी शर्तें

जारी रखने से पहले, पक्का करें कि आपके पास ये हैं:

  • आपके Google Ad Manager नेटवर्क पर डीएआई पॉड के विज्ञापन दिखाने की सुविधा चालू हो गई है.
  • लाइव स्ट्रीम इवेंट, जिसमें Pod सर्विंग मेनिफ़ेस्ट टाइप हो. इवेंट बनाने के लिए, देखें डीएआई के लिए लाइव स्ट्रीम सेट अप करें.

सुझावों को फ़ॉलो करें

हमारा सुझाव है कि विज्ञापन पॉड का मेनिफ़ेस्ट यूआरएल जनरेट करने से पहले, विज्ञापन के लिए ब्रेक की सूचना देने वाले एपीआई (ईएबीएन) को कॉल करें. इससे, हर विज्ञापन के लिए ब्रेक की अनुमानित अवधि, टारगेटिंग की जानकारी, और अन्य पैरामीटर की जानकारी दी जा सकती है.

प्रोडक्शन और टेस्ट स्ट्रीम के लिए, EABN API को कॉल करें. खास तौर पर तब, जब आपका विज्ञापन नेटवर्क पर कोई प्रोग्रामेटिक कैंपेन हो. ज़्यादा जानकारी के लिए, यह देखें प्रोग्रामैटिक डायरेक्ट की सुविधाएं और दिशा-निर्देश.

स्ट्रीम के रजिस्ट्रेशन के लिए अनुरोध करना

जब कोई उपयोगकर्ता आपके वीडियो प्लेयर ऐप्लिकेशन में कॉन्टेंट स्ट्रीम शुरू करता है, तो एक स्ट्रीम बनाई जाती है स्ट्रीमिंग सेशन बनाने के लिए, टारगेटिंग पैरामीटर के साथ रजिस्ट्रेशन का अनुरोध के बारे में हमारा दूसरा वीडियो देखें. स्ट्रीम के रजिस्ट्रेशन के लिए अनुरोध करने से जुड़ी जानकारी पाने के लिए, यहां देखें Method:stream. इसके बाद, आपको जवाब का डेटा अनुरोध से.

यहां ऐसे उदाहरण दिए गए हैं जिनसे स्ट्रीम के रजिस्ट्रेशन का अनुरोध किया जाता है:

सादा लेख HTTP

  • अनुरोध:
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
  • जवाब:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

शेल

  • कमांड लाइन:
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
  • आउटपुट:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

JavaScript

  • फे़च एपीआई का इस्तेमाल करना:
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);
  • कंसोल लॉग:
{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

विज्ञापन के लिए ब्रेक के मेटाडेटा के लिए पोल

स्ट्रीम के रजिस्ट्रेशन का अनुरोध करने के बाद, विज्ञापन के मेटाडेटा के लिए पोल करें. यहां की यात्रा पर हूं पोल का इस्तेमाल करके, आपने स्ट्रीम के रिस्पॉन्स में polling_frequence का इस्तेमाल करके टाइमर सेट किया है विज्ञापन को कॉल करने के लिए रजिस्ट्रेशन चरण मेटाडेटा. हर पोल के लिए, आपको मेटाडेटा के साथ विज्ञापनों की कुछ सूची मिल सकती है. उपलब्ध होने चाहिए.

विज्ञापनों के पॉड मेनिफ़ेस्ट का यूआरएल जनरेट करें

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

इस उदाहरण में, विज्ञापन के पॉड मेनिफ़ेस्ट के यूआरएल का स्ट्रक्चर बताया गया है:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

विज्ञापन के लिए ब्रेक के आधार पर, विज्ञापनों के पॉड मेनिफ़ेस्ट यूआरएल पैरामीटर को कैलकुलेट किया जा सकता है वीडियो प्लेयर या सर्वर की सूचना से मिली जानकारी. इसके लिए इन पैरामीटर की ज़रूरी शर्तें देखें. तरीका: पॉड मेनिफ़ेस्ट.

विज्ञापनों का पॉड मेनिफ़ेस्ट चलाएं

क्लाइंट वीडियो प्लेयर ऐप्लिकेशन पर, किसी मुख्य फ़ाइल का इस्तेमाल करके कॉन्टेंट स्ट्रीम करना शुरू करें अपने वीडियो प्लेयर पर जाएं और अपने वीडियो प्लेयर के दस्तावेज़ का पालन करें. ज़रूरी होने पर, प्लेबैक और विज्ञापन शेड्यूल.

अगर विज्ञापन पॉड मेनिफ़ेस्ट यूआरएल जनरेट किए जाते हैं और उन्हें सर्वर साइड, वीडियो प्लेयर के आने वाले विज्ञापन ब्रेक इवेंट पर नज़र रखें, और पक्का करें कि विज्ञापन के लिए हर ब्रेक के दौरान id3 इवेंट की सदस्यता लेना. अगर विज्ञापन को शेड्यूल किया जाता है, तो क्लाइंट साइड से इवेंट ब्रेक करें, बनाने पर id3 इवेंट की सदस्यता लें.

इंप्रेशन और विज्ञापन इवेंट रिपोर्ट करना

जब किसी वीडियो प्लेयर को विज्ञापनों का पॉड चलाता है और उसे id3 के समय वाला मेटाडेटा मिलता है, विज्ञापन इवेंट सुनना जिसे वीडियो प्लेयर ट्रिगर करता है और प्रोसेस करता है. मीडिया की पुष्टि करने के लिए पिंग भेजें.