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

इस गाइड में बताया गया है कि वीओडी स्ट्रीम का अनुरोध करने के लिए, डीएआई एपीआई का इस्तेमाल कैसे किया जाए स्किप किए जा सकने वाले विज्ञापन, 'स्किप करें' बटन को इस हिसाब से रेंडर करें 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

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

'अभी नहीं' बटन की पोज़िशन

बाईं से दाईं ओर लिखी जाने वाली भाषा के लिए, 'स्किप करें' बटन को इसके नीचे दाईं ओर रखें वीडियो प्लेयर. दाईं से बाईं ओर लिखी जाने वाली भाषा के लिए, 'स्किप करें' बटन को वीडियो प्लेयर के नीचे बाईं ओर.

'अभी नहीं' बटन का साइज़

बटन और टेक्स्ट का साइज़ इतना बड़ा होना चाहिए कि वे आसानी से पढ़े जा सकें अनुभव.

टेक्स्ट और आइकॉन

'स्किप करें' बटन में टेक्स्ट और आइकोनोग्राफ़ी, दोनों होने चाहिए. Google आपके यूआरएल पैरामीटर को कैसे इस्तेमाल करेगा, यह तय करने के लिए आइकॉनोग्राफ़ी के तौर पर अगली सामग्री छोड़ें आइकॉन पर टैप करें.

सुलभता

उपयोगकर्ता के पास कीबोर्ड का इस्तेमाल करके 'स्किप करें' बटन पर जाने की सुविधा होनी चाहिए या रिमोट कंट्रोल. काउंटडाउन के बाद ऐप्लिकेशन को 'स्किप करें' बटन पर फ़ोकस करना चाहिए पूरा हुआ.

इंटरनैशनलाइजेशन

हमारा सुझाव है कि स्किप किए गए टेक्स्ट का अनुवाद उपयोगकर्ता की भाषा में करें.

विज्ञापनों का पॉड

स्किप बटन का इस्तेमाल, विज्ञापनों के पॉड में मौजूदा विज्ञापन को स्किप करने या स्किप करने के लिए किया जा सकता है पॉड को टारगेट कर रहे थे.

'विज्ञापन छोड़ें' अनुवाद

इस्तेमाल की जाने वाली चीज़ें skipAdTranslations.json फ़ाइल आपके 'विज्ञापन छोड़ें' का अनुवाद करने के लिए उपयोगकर्ता की भाषा के आधार पर टेक्स्ट.