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" प्रॉपर्टी है, जो डेंसिटी-इंडिपेंडेंट पिक्सल (DP) में होती है.

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

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

वीएएसटी 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" एट्रिब्यूट वीएएसटी में शामिल आइकॉन से मेल खाता है.

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

आने वाले समय में 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 आइकॉन से लिया गया 1:1 अनुवाद है स्टैंडर्ड (सेक्शन 3.11), जहां भी संभव हो. हालांकि, ज़्यादा सख्त 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 फ़ॉलबैक इमेज का 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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}