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

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

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

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

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

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

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

VAST XML रिस्पॉन्स से 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 आइकॉन और कस्टम 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 आइकॉन के प्रोग्राम एट्रिब्यूट से मेल खाता है.
इस नोड का स्ट्रक्चर, IconClickFallbackImages के लिए VAST 4.2 स्टैंडर्ड से मेल खाता है. हालांकि, इसमें program एट्रिब्यूट जोड़ा गया है.
--IconClickFallbackImage चौड़ाई इमेज दिखाने के लिए, पसंदीदा चौड़ाई.
ऊंचाई इमेज दिखाने के लिए पसंदीदा ऊंचाई.
---AltText इमेज के बारे में सुलभ जानकारी.
---StaticResource creativeType फ़ॉलबैक इमेज का माइम टाइप.
यह एक सीडीएटीए वैल्यू है. इसमें फ़ॉलबैक इमेज का यूआरएल होता है.

वीएएसटी 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 ऑब्जेक्ट में, विज्ञापन आईडी के हिसाब से विज्ञापन की सूची होती है. हर विज्ञापन ऑब्जेक्ट में, icons array मौजूद होता है. अगर सवाल में दिए गए विज्ञापन में 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 आइकॉन के लिए दी गई इमेज का माइम टाइप. डिफ़ॉल्ट रूप से, इसकी वैल्यू "image/png" होती है.
रिसॉर्स AdChoices आइकॉन को वापस पाने के लिए यूआरएल.
alt_text AdChoices आइकॉन के लिए रेंडर किया जाने वाला वैकल्पिक लेख.
click_data यह एक ऑब्जेक्ट है. इसमें click_data.url प्रॉपर्टी होती है. यह प्रॉपर्टी, उस यूआरएल को दिखाती है जिस पर व्यूअर को रीडायरेक्ट किया जाता है. ऐसा तब होता है, जब वे वेब ब्राउज़िंग की सुविधा देने वाले किसी प्लैटफ़ॉर्म पर AdChoices आइकॉन पर क्लिक करते हैं.
click_fallback_images इमेज ऑब्जेक्ट की एक ऐसी कैटगरी जिसे उन लोगों को दिखाया जाता है जो वेब ब्राउज़िंग की सुविधा नहीं देने वाले प्लैटफ़ॉर्म पर AdChoices आइकॉन पर क्लिक करते हैं.

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

चौड़ाई फ़ॉलबैक इमेज की चौड़ाई, पिक्सल में.
ऊंचाई फ़ॉलबैक इमेज की ऊंचाई, पिक्सल में.
creative_type फ़ॉलबैक इमेज का माइम टाइप. डिफ़ॉल्ट रूप से, इसकी वैल्यू "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}