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

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

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

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

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

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

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

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

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

VAST 4.2

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

अगर आपके ऐप्लिकेशन में वीएएसटी 4.2 आइकॉन काम नहीं करते, तो आपको आइकॉन मैन्युअल रूप से पार्स करने होंगे "GoogleWhatThisAd" प्रोग्राम उसके आधार पर आपके वीएएसटी (वीडियो विज्ञापन देने के लिए टेंप्लेट) रिस्पॉन्स से मानक. अपने ऐप्लिकेशन में ज़्यादा टेस्टिंग के लिए, इस सैंपल 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>

वीएएसटी 3.0

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

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

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

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

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

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

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

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

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