स्किप किए जा सकने वाले वीओडी (वीडियो ऑन डिमांड) स्ट्रीम वाले विज्ञापन

इस गाइड में, DAI API का इस्तेमाल करके स्किप किए जा सकने वाले विज्ञापनों के साथ वीओडी स्ट्रीम का अनुरोध करने, 'स्किप करें' बटन को Google Ads की ज़रूरी शर्तों के हिसाब से रेंडर करने, और उससे जुड़े ट्रैकिंग इवेंट भेजने का तरीका बताया गया है.

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

स्किप किए जा सकने वाले विज्ञापनों के लिए अनुरोध करें

स्किप किए जा सकने वाले विज्ञापनों वाली वीओडी स्ट्रीम का अनुरोध करने के लिए, आपको स्ट्रीम के अनुरोध में 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 विज्ञापन के लिए ब्रेक की सूची.
start (number) स्ट्रीम में ब्रेक की स्थिति सेकंड में डालें.
duration (number) विज्ञापन के लिए ब्रेक की अवधि, सेकंड में.
ads (object(Ad)) स्ट्रीम में मौजूद विज्ञापनों की सूची.
start (number) विज्ञापन स्ट्रीम में विज्ञापन की जगह सेकंड में दिखाई जाती है.
duration (number) विज्ञापन की अवधि, सेकंड में.
skip_metadata (object(स्किपMetadata)) स्किप किए जा सकने वाले विज्ञापनों के लिए वैकल्पिक मेटाडेटा. अगर यह नीति सेट की जाती है, तो इससे पता चलता है कि विज्ञापन को स्किप किया जा सकता है. साथ ही, इसमें स्किप यूज़र इंटरफ़ेस (यूआई) और ट्रैकिंग इवेंट को मैनेज करने के तरीके से जुड़े निर्देश शामिल हैं.
offset (number) ऑफ़सेट से पता चलता है कि विज्ञापन में प्लेयर को 'स्किप करें' बटन को रेंडर करने के लिए कितने सेकंड का इंतज़ार करना होगा. वीएएसटी में उपलब्ध न होने पर इसे शामिल नहीं किया जाता.
tracking_url (string) ऐसा यूआरएल जिसे स्किप इवेंट पर पिंग किया जाना चाहिए.

रिस्पॉन्स का उदाहरण

{
  ...
  "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 फ़ाइल का इस्तेमाल करें.