AdChoices आइकॉन और ओवरले

Google के होस्ट किए गए, दिलचस्पी के मुताबिक विज्ञापन दिखाने वाले सभी ऐप्लिकेशन को, AdChoices आइकॉन और ओवरले लागू करना होगा. हालांकि, ऐसा तब ही करना होगा, जब Google ने उन्हें उपलब्ध कराया हो. AdChoices, पारदर्शिता से जुड़ी एक सुविधा है. इसे "यह विज्ञापन क्यों?" भी कहा जाता है. इसकी मदद से, उपयोगकर्ताओं को यह बताया जाता है कि उन्हें कोई खास विज्ञापन क्यों दिखाया जा रहा है. साथ ही, यह भी बताया जाता है कि उनकी निजता को कैसे सुरक्षित रखा जाता है.

ज़्यादा जानकारी के लिए, आपको विज्ञापन क्यों दिख रहा है लेख पढ़ें.

इस गाइड में, अपने विज्ञापन के VAST एक्सएमएल रिस्पॉन्स या अपनी डीएआई स्ट्रीम के मेटाडेटा रिस्पॉन्स से, AdChoices को सही तरीके से लागू करने के लिए ज़रूरी जानकारी निकालने का तरीका बताया गया है.

AdChoices को रेंडर करने से जुड़ी ज़रूरी शर्तें

AdChoices आइकॉन को रेंडर करने के लिए, Google की ज़रूरी शर्तों का पालन करने के लिए, आपके ऐप्लिकेशन या वेबसाइट को ये स्टैंडर्ड पूरे करने होंगे:

  1. AdChoices आइकॉन, उस विज्ञापन के ऊपर ओवरले करके दिखाया जाना चाहिए जिसके लिए इसे उपलब्ध कराया गया है
  2. AdChoices आइकॉन को उस जगह पर दिखाया जाना चाहिए जो आइकॉन डेटा में शामिल "X लोकेशन" और "Y लोकेशन" प्रॉपर्टी से तय होती है. साथ ही, इसे चौड़ाई और ऊंचाई प्रॉपर्टी से तय किए गए साइज़ में, डेंसिटी-इंडिपेंडेंट पिक्सल (डीपी) में दिखाया जाना चाहिए.
  3. AdChoices आइकॉन को दूसरे विज्ञापन ओवरले या इंटरफ़ेस एलिमेंट से छिपाया नहीं जाना चाहिए.
  4. क्लिक करने या टच करने या रिमोट से चुनने जैसे विकल्पों वाले प्लैटफ़ॉर्म पर, AdChoices आइकॉन पर क्लिक किया जा सकता है.
  5. जिन प्लैटफ़ॉर्म पर ब्राउज़र काम करता है उन पर AdChoices आइकॉन पर क्लिक करने से, "ClickThrough" या "click_data" प्रॉपर्टी में दिए गए यूआरएल वाला ब्राउज़र टैब या विंडो खुलनी चाहिए.
  6. जिन प्लैटफ़ॉर्म पर ब्राउज़र काम नहीं करता उन पर AdChoices आइकॉन पर क्लिक करने से, एक मॉडल ओवरले खुलना चाहिए. इसमें "IconClickFallbackImage" या "click_fallback_images" प्रॉपर्टी में बताई गई इमेज में से कोई एक इमेज दिखनी चाहिए.
  7. जिन प्लैटफ़ॉर्म पर ब्राउज़र काम नहीं करता उन पर फ़ॉलबैक इमेज, "IconClickFallbackImage" या "click_fallback_images" प्रॉपर्टी में बताए गए साइज़ में, डेंसिटी इंडिपेंडेंट पिक्सल (डीपी) में दिखनी चाहिए.

VAST एक्सएमएल रिस्पॉन्स से AdChoices को पार्स करना

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

VAST 4.2

अगर आपका एक्सएमएल विज्ञापन रिस्पॉन्स, VAST 4.2 स्टैंडर्ड के मुताबिक है, तो AdChoices को VAST आइकॉन के तौर पर डिलीवर किया जाता है. अगर आपका ऐप्लिकेशन या वेबसाइट, वीएएसटी 4.2 आइकॉन (वीएएसटी 4.2 स्टैंडर्ड का सेक्शन 3.11) के साथ पूरी तरह से काम करती है, तो AdChoices के साथ काम करने के लिए कुछ और करने की ज़रूरत नहीं है.

अगर आपका ऐप्लिकेशन, VAST 4.2 आइकॉन के साथ काम नहीं करता, तो आपको उस स्टैंडर्ड के आधार पर, अपने VAST रिस्पॉन्स से "GoogleWhyThisAd" प्रोग्राम के नाम वाले आइकॉन को मैन्युअल तरीके से पार्स करना होगा. अपने ऐप्लिकेशन में ज़्यादा टेस्टिंग के लिए, इस सैंपल VAST 4.2 एक्सएमएल का इस्तेमाल किया जा सकता है.

VAST 4.2 रिस्पॉन्स का सैंपल

<?xml version="1.0" encoding="UTF-8"?>
<VAST version="4.2">
  <Ad id="20011">
    <Wrapper>
      ...
      <Creatives>
        ...
        <Creative id="5480" sequence="1">
          ...
          <Linear>
            ...
            <Icons>
              ...
              <Icon program="GoogleWhyThisAd" width="40" height="30" xPosition="left" yPosition="100" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="AdChoices icon">
                <StaticResource creativeType="image/png">
                  <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png ]]>
                </StaticResource>
                <IconClicks>
                  <IconClickThrough>
                    <![CDATA[ https://g.co/adsettings ]]>
                  </IconClickThrough>
                  <IconClickFallbackImages>
                    <IconClickFallbackImage width="950" height="600">
                      <AltText>
                        <![CDATA[ This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing. ]]>
                      </AltText>
                      <StaticResource creativeType="image/png">
                        <![CDATA[ https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png ]]>
                      </StaticResource>
                    </IconClickFallbackImage>
                    ...
                  </IconClickFallbackImages>
                </IconClicks>
              </Icon>
              ...
            </Icons>
            ...
          </Linear>
          ...
        </Creative>
        ...
      </Creatives>
      ...
    </Wrapper>
    ...
  </Ad>
</VAST>

VAST 3.0

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

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

AdChoices के साथ पूरी तरह से काम करने के लिए, प्रोग्राम के नाम "GoogleWhyThisAd" वाले IconFallbackImages टैग को, प्रोग्राम के नाम "GoogleWhyThisAd" वाले आइकॉन से जोड़ा जाना चाहिए. ऐसा करने पर, जब उपयोगकर्ता आइकॉन के साथ इंटरैक्ट करता है, तो उससे जुड़ी फ़ॉलबैक इमेज दिखती है.

आने वाले समय में AdChoices स्टैंडर्ड में होने वाले संभावित बदलावों के हिसाब से, हमारा सुझाव है कि सभी VAST आइकॉन के लिए फ़ॉलबैक इमेज का इस्तेमाल करें. हालांकि, ऐसा तब ही करें, जब यह सुविधा उपलब्ध हो. अपने ऐप्लिकेशन में ज़्यादा टेस्टिंग के लिए, इस सैंपल VAST 3.0 xml का इस्तेमाल किया जा सकता है.

IconFallbackImages एक्सटेंशन का स्ट्रक्चर

टैग विशेषताएं ब्यौरा
Extension टाइप इस एक्सटेंशन के लिए, टाइप में हमेशा वैल्यू IconClickFallbackImages होती है.
-IconClickFallbackImages प्रोग्राम यह एट्रिब्यूट, हमेशा किसी VAST 3.0 आइकॉन के प्रोग्राम एट्रिब्यूट से मेल खाता है.
इस नोड का स्ट्रक्चर, आइकॉन क्लिक फ़ॉलबैक इमेज के लिए VAST 4.2 स्टैंडर्ड से मेल खाता है. हालांकि, इसमें program एट्रिब्यूट जोड़ा गया है.
--IconClickFallbackImage चौड़ाई इमेज को दिखाने के लिए पसंदीदा चौड़ाई.
ऊंचाई इमेज को दिखाने के लिए पसंदीदा ऊंचाई.
---AltText इमेज के बारे में जानकारी, जो सुलभ हो.
---StaticResource creativeType फ़ॉलबैक इमेज का mime टाइप.
फ़ॉलबैक इमेज का यूआरएल शामिल करने वाली CDATA वैल्यू.

VAST 3.0 रिस्पॉन्स का सैंपल

<?xml version="1.0" encoding="UTF-8"?>
<VAST xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="vast.xsd" version="3.0">
 <Ad id="123456">
  <InLine>
   ...
   <Creatives>
    ...
    <Creative id="7891011" AdID="ABCD123456EF" sequence="1">
     ...
     <Linear>
      ...
      <Icons>
       ...
       <Icon program="GoogleWhyThisAd" width="50" height="50" xPosition="20" yPosition="bottom" duration="00:00:10" offset="00:00:00" apiFramework="VAST" altText="Why This Ad?">
        <StaticResource creativeType="image/png">
         <![CDATA[https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png]]>
        </StaticResource>
        <IconClicks>
         ...
         <IconClickThrough><![CDATA[https://g.co/adsettings]]></IconClickThrough>
        </IconClicks>
       </Icon>
       ...
      </Icons>
     ...
     </Linear>
     ...
    </Creative>
    ...
   </Creatives>
   <Extensions>
    ...
    <Extension type="IconClickFallbackImages">
     ...
     <IconClickFallbackImages program="GoogleWhyThisAd">
      <IconClickFallbackImage width="400" height="150">
       <AltText>Alt icon fallback</AltText>
       <StaticResource creativeType="image/png"><![CDATA[https://storage.googleapis.com/gvabox/nickchavez/media/png/wta_dialog.png]]></StaticResource>
      </IconClickFallbackImage>
      ...
     </IconClickFallbackImages>
     ...
    </Extension>
    ...
   </Extensions>
   ...
  </InLine>
  ...
 </Ad>
</VAST>

DAI API मेटाडेटा JSON से AdChoices को पार्स करना

DAI API के साथ काम करते समय, AdChoices की जानकारी को JSON ऑब्जेक्ट के ज़रिए पास किया जाता है. यह ऑब्जेक्ट, मेटाडेटा यूआरएल के अनुरोधों से मिलता है.

मेटाडेटा JSON ऑब्जेक्ट में विज्ञापनों की सूची होती है, जिसे adID के हिसाब से क्रम में लगाया जाता है. हर विज्ञापन ऑब्जेक्ट में आइकॉन का कलेक्शन होता है. अगर जिस विज्ञापन की शिकायत की गई है उसमें AdChoices का इस्तेमाल किया गया है, तो उस ऐरे में AdChoices आइकॉन शामिल होगा.

JSON आइकॉन फ़ॉर्मैट

जहां भी संभव हो, JSON आइकॉन फ़ॉर्मैट, VAST 4.2 आइकॉन स्टैंडर्ड (सेक्शन 3.11) से 1:1 अनुवाद होता है. हालांकि, ज़्यादा सख्त JSON फ़ॉर्मैट के साथ काम करने के लिए, कुछ एट्रिब्यूट के नाम बदल दिए गए हैं.

आइकॉन का JSON फ़ॉर्मैट

प्रोग्राम AdChoices आइकॉन के लिए, इस वैल्यू में हमेशा "GoogleWhyThisAd" स्ट्रिंग शामिल होती है.
x_position वीडियो क्रिएटिव के सबसे ऊपर बाएं कोने के हिसाब से, आइकॉन के सबसे ऊपर बाएं कोने की हॉरिज़ॉन्टल पोज़िशन, पिक्सल में. यह फ़ील्ड, रिस्पॉन्सिव पोज़िशन की वैल्यू "right" या "left" भी स्वीकार करता है.
y_position वीडियो क्रिएटिव के सबसे ऊपर बाएं कोने के हिसाब से, आइकॉन के सबसे ऊपर बाएं कोने की वर्टिकल पोज़िशन, पिक्सल में. यह फ़ील्ड, रिस्पॉन्सिव डिज़ाइन में एलिमेंट की पोज़िशन के लिए "top" या "bottom" वैल्यू भी स्वीकार करता है.
चौड़ाई आइकॉन की चौड़ाई, पिक्सल में.
ऊंचाई आइकॉन की ऊंचाई, पिक्सल में.
creative_type आइकॉन के लिए दी गई इमेज का MIME टाइप. डिफ़ॉल्ट रूप से, "image/png" पर सेट होती है.
संसाधन AdChoices आइकॉन को वापस लाने के लिए यूआरएल.
alt_text AdChoices आइकॉन के लिए रेंडर किया जाने वाला वैकल्पिक टेक्स्ट.
click_data click_data.url प्रॉपर्टी वाला ऑब्जेक्ट, जो वेब ब्राउज़िंग की सुविधा देने वाले प्लैटफ़ॉर्म पर AdChoices आइकॉन पर क्लिक करने पर, दर्शकों को रीडायरेक्ट करने के लिए यूआरएल दिखाता है.
click_fallback_images वेब ब्राउज़िंग की सुविधा न देने वाले प्लैटफ़ॉर्म पर, AdChoices आइकॉन पर क्लिक करने वाले दर्शकों को दिखाने के लिए इमेज ऑब्जेक्ट का कलेक्शन.

फ़ॉलबैक इमेज का JSON फ़ॉर्मैट

चौड़ाई फ़ॉलबैक इमेज की चौड़ाई, पिक्सल में.
ऊंचाई फ़ॉलबैक इमेज की ऊंचाई, पिक्सल में.
creative_type फ़ॉलबैक इमेज का mime टाइप. डिफ़ॉल्ट रूप से, "image/png" पर सेट होती है.
संसाधन फ़ॉलबैक इमेज को वापस लाने के लिए यूआरएल.
alt_text फ़ॉलबैक इमेज के लिए रेंडर किया जाने वाला वैकल्पिक लेख.

मेटाडेटा का JSON सैंपल

{
  ...
  "ads": {
    ...
    "0002640412_ad1": {
      ...
      "icons": [
        ...
        {
          "alt_text": "AdChoices icon",
          "click_data": {
            "url": "https://g.co/adsettings"
          },
          "click_fallback_images": [
            {
              "alt_text": "This ad was shown to you based on: * Google's estimation of your interests, based on your activity on Google on this device (for example, your searches) * the information on the website you were viewing.",
              "creative_type": "image/jpg",
              "height": 600,
              "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices_fallback_image.png",
              "width": 950
            }
          ],
          "creative_type": "image/png",
          "height": 30,
          "program": "AdChoices",
          "resource": "https://storage.googleapis.com/interactive-media-ads/hosted-samples/wta/icon_adchoices.png",
          "type": "static",
          "width": 40,
          "x_position": "0",
          "y_position": "100"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}