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" प्रॉपर्टी में बताए गए साइज़ में, डेंसिटी इंडिपेंडेंट पिक्सल (डीपी) में दिखनी चाहिए.

VAST एक्सएमएल रिस्पॉन्स से AdChoices को पार्स करना

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

VAST 4.2

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

वीएएसटी 3.0

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

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

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

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

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

टैग विशेषताएं ब्यौरा
Extension टाइप इस एक्सटेंशन के लिए, टाइप में हमेशा वैल्यू मौजूद होती है IconClickFallbackImages.
-IconClickFallbackImages प्रोग्राम यह एट्रिब्यूट, हमेशा किसी VAST 3.0 आइकॉन के प्रोग्राम एट्रिब्यूट से मेल खाता है.
इस नोड की संरचना इसके लिए VAST 4.2 मानक से मेल खाती है आइकॉनClickFallbackImage, 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 को पार्स करें

DAI API के साथ काम करते समय, AdChoices की जानकारी को JSON ऑब्जेक्ट के ज़रिए पास किया जाता है. यह ऑब्जेक्ट, मेटाडेटा यूआरएल के अनुरोधों से मिलता है.

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

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

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