वीओडी स्ट्रीम में स्किप किए जा सकने वाले विज्ञापन दिखाने की सुविधा चालू करना

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

जवाब का उदाहरण

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