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

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

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

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

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

वीएएसटी 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 3.0 आइकॉन स्टैंडर्ड के साथ पूरी तरह से काम करती है और अगर प्लैटफ़ॉर्म, आइकॉन क्लिकथ्रू यूआरएल पर नेविगेट करने और उसे दिखाने में सक्षम है, तो AdChoices के साथ काम करने के लिए कुछ और करने की ज़रूरत नहीं है.

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

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

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

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

वीएएसटी 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 के हिसाब से क्रम में लगाया जाता है. हर विज्ञापन ऑब्जेक्ट में, icons कलेक्शन होता है. अगर विज्ञापन में AdChoices का इस्तेमाल किया जाता है, तो AdChoices आइकॉन इस कलेक्शन में शामिल होता है.

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

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

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

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

मेटाडेटा 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}