इस गाइड में, DAI API का इस्तेमाल करके स्किप किए जा सकने वाले विज्ञापनों के साथ वीओडी स्ट्रीम का अनुरोध करने, 'स्किप करें' बटन को Google Ads की ज़रूरी शर्तों के हिसाब से रेंडर करने, और उससे जुड़े ट्रैकिंग इवेंट भेजने का तरीका बताया गया है.
ज़रूरी शर्तें
- वीओडी स्ट्रीम के लिए डीएआई एपीआई कॉल लागू करने वाला ऐप्लिकेशन. ज़्यादा जानकारी के लिए, DAI API की वीओडी स्ट्रीम गाइड देखें.
स्किप किए जा सकने वाले विज्ञापनों के लिए अनुरोध करें
स्किप किए जा सकने वाले विज्ञापनों वाली वीओडी स्ट्रीम का अनुरोध करने के लिए, आपको स्ट्रीम के अनुरोध में dai-sas
पैरामीटर को पास करना होगा.
एपीआई एंडपॉइंट
POST: /ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
Host: dai.google.com
Content-Type: application/x-www-form-urlencoded
पाथ पैरामीटर
{CMS_ID} |
स्ट्रीम का कॉन्टेंट मैनेजमेंट सिस्टम आईडी. |
{VIDEO_ID} |
स्ट्रीम का वीडियो आईडी |
मुख्य भाग के पैरामीटर
dai-sas |
स्किप किए जा सकने वाले विज्ञापन चालू करने के लिए, dai-sas=1 को सेट करें.
|
अनुरोध का उदाहरण (cURL)
एचएलएस स्ट्रीम के अनुरोधों के लिए:
curl -X POST \
-d 'dai-sas=1' \
-H 'Content-Type: application/x-www-form-urlencoded' \
https://dai.google.com/ondemand/v1/hls/content/{CMS_ID}/vid/{VIDEO_ID}/stream
डैश स्ट्रीम के यूआरएल में 'dash'
को बदलें:
https://dai.google.com/ondemand/v1/dash/content/{CMS_ID}/vid/{VIDEO_ID}/stream
अपने अनुरोध के मुख्य हिस्से में एक से ज़्यादा स्ट्रीम पैरामीटर शामिल करने के लिए, यहां दिए गए फ़ॉर्मैट का इस्तेमाल करें:
-d 'dai-sas=1&cust_params=key1%3dvalue1%26key2%3dvalue2' \
विज्ञापन स्किप करने से जुड़ी समस्याएं हल करना
विज्ञापन स्किप किए जाने को मैनेज करने के लिए, Ad
निर्देश या AdBreak
निर्देश में दी गई जानकारी का इस्तेमाल करें. यह इस बात पर निर्भर करता है कि विज्ञापन को स्किप किया जा रहा है या मौजूदा विज्ञापन को स्किप किया जा रहा है.
start
वैल्यू लें और duration
वैल्यू जोड़ें. इसके बाद, स्ट्रीम में उस पॉइंट पर जाएं. SkipMetadata
सबमैसेज में offset
वैल्यू भी शामिल होती है. यह विज्ञापन स्किप किए जाने से पहले, सेकंड के लिए तय की गई वैल्यू होती है. SkipMetadata
सबमैसेज को सिर्फ़ उन विज्ञापनों में शामिल किया जाएगा जिन्हें स्किप किया जा सकता है.
ad_breaks |
विज्ञापन के लिए ब्रेक की सूची.
|
रिस्पॉन्स का उदाहरण
{
...
"ad_breaks":[
{
...
"start":0,
"duration":10,
"ads":[
{
...
"start":0,
"duration":10,
"skip_metadata":{
"offset": 5,
"tracking_url": "https://example_skip_url.com"
}
}
}
}
विज्ञापन स्किप करने के बाद, स्ट्रीम के रिस्पॉन्स में शामिल स्किप इवेंट के यूआरएल को पिंग करें.
यह जानकारी SkipMetadata
सबमैसेज में शामिल है.
'अभी नहीं' बटन के लिए ज़रूरी शर्तें
स्किप किए जा सकने वाले विज्ञापनों के लिए, 'स्किप करें' बटन को डिज़ाइन से जुड़ी इन ज़रूरी शर्तों के हिसाब से रेंडर करें. इन ज़रूरी शर्तों को पूरा न करने पर, आपकी साइट या ऐप्लिकेशन पर दिखाए जाने वाले Google विज्ञापनों पर पाबंदियां लगाई जा सकती हैं.
काउंटडाउन टाइमर
विज्ञापन को तब तक स्किप नहीं किया जा सकता, जब तक कि VAST (वीडियो विज्ञापन देने के लिए टेंप्लेट) में तय skipoffset
समय तक नहीं बताया गया हो.
स्किप न की जा सकने वाली इस अवधि के दौरान, आपको उपयोगकर्ता को एक सूचना दिखानी होगी कि
उसमें यह बताया जाना चाहिए कि विज्ञापन को X सेकंड में स्किप किया जा सकता है. सूचना का अनुवाद उपयोगकर्ता की भाषा में किया जाना चाहिए.
'अभी नहीं' बटन की पोज़िशन
बाईं से दाईं ओर लिखी जाने वाली भाषा के लिए, वीडियो प्लेयर के नीचे दाईं ओर 'स्किप करें' बटन को डालें. दाईं से बाईं ओर लिखी जाने वाली भाषा के लिए, वीडियो प्लेयर के नीचे बाईं ओर 'स्किप करें' बटन रखें.
'अभी नहीं' बटन का साइज़
बटन और टेक्स्ट इतने बड़े होने चाहिए कि वे आसानी से समझ में आने लगें.
टेक्स्ट और आइकॉन
'स्किप करें' बटन में टेक्स्ट और आइकोनोग्राफ़ी, दोनों होने चाहिए. आइकॉनोग्राफ़ी के तौर पर अगले मटीरियल को छोड़ें आइकॉन का इस्तेमाल किया जा सकता है.
सुलभता
उपयोगकर्ता के पास कीबोर्ड या रिमोट कंट्रोल का इस्तेमाल करके, 'स्किप करें' बटन पर जाने का विकल्प होना चाहिए. काउंटडाउन पूरा हो जाने के बाद ऐप को 'स्किप करें' बटन पर फ़ोकस करना चाहिए.
इंटरनैशनलाइजेशन
हमारा सुझाव है कि स्किप किए गए टेक्स्ट का अनुवाद उपयोगकर्ता की भाषा में करें.
विज्ञापनों का पॉड
स्किप बटन का इस्तेमाल, विज्ञापनों के पॉड के मौजूदा विज्ञापन को स्किप करने या पूरे पॉड को छोड़ने के लिए किया जा सकता है.
'विज्ञापन छोड़ें' अनुवाद
उपयोगकर्ता की स्थान-भाषा के आधार पर, 'विज्ञापन छोड़ें' टेक्स्ट का अनुवाद करने के लिए, skipAdTranslations.json
फ़ाइल का इस्तेमाल करें.