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

Google की ओर से होस्ट किए गए, लोगों के हिसाब से दिखाए जाने वाले विज्ञापन दिखाने वाले सभी ऐप्लिकेशन को Google की ओर से उपलब्ध कराए गए AdChoices आइकॉन और ओवरले को लागू करना होगा. AdChoices

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

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

AdChoices रेंडरिंग की ज़रूरी शर्तें

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

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

VAST एक्सएमएल जवाब से, AdChoices पार्स करें

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

VAST 4.2

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

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

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

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

आइकॉनFallbackImage एक्सटेंशन स्ट्रक्चर

टैग करें एट्रिब्यूट ब्यौरा
एक्सटेंशन टाइप करें इस एक्सटेंशन के लिए, टाइप में हमेशा IconClickFallbackImages वैल्यू शामिल होती है.
-IconClickFallback इमेज प्रोग्राम यह एट्रिब्यूट हमेशा किसी VAST (वीडियो विज्ञापन देने के लिए टेम्प्लेट) 3.0 आइकॉन के प्रोग्राम एट्रिब्यूट से मेल खाता है.
इस नोड की संरचना, IconClickFallbackImages के लिए VAST 4.2 मानक से मेल खाती है, लेकिन program एट्रिब्यूट को नहीं जोड़ा गया है.
--IconClickFallbackImage width इमेज दिखाने के लिए पसंदीदा चौड़ाई.
ऊंचाई इमेज दिखाने के लिए पसंदीदा ऊंचाई.
---AltText इमेज की ऐसी जानकारी जिसे ऐक्सेस किया जा सके.
---StaticResource creativeType फ़ॉलबैक इमेज का mimetype.
फ़ॉलबैक इमेज का यूआरएल वाली सीएटीए वैल्यू.

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

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

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

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

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

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

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