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 सिर्फ़ वीएएसटी में काम करते हैं वर्शन 3.0 और उसके बाद के वर्शन. AdChoices को वीएएसटी आइकॉन के तौर पर लागू किया गया है.

वीएएसटी 4.2

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

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

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

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

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

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

वीएएसटी 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 ऑब्जेक्ट के ज़रिए पास किया जाता है, जो मेटाडेटा को अनुरोध करने पर मिलता है यूआरएल.

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

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

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

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

प्रोग्राम AdChoices आइकॉन के लिए, इस वैल्यू में हमेशा "GoogleWhatThisAd" स्ट्रिंग हमेशा मौजूद होती है.
x_position आइकॉन के सबसे ऊपर बाएं कोने की हॉरिज़ॉन्टल पोज़िशन, वीडियो क्रिएटिव के ऊपरी बाएँ कोने में, पिक्सल में. यह फ़ील्ड भी स्वीकार करता है रिस्पॉन्सिव पोज़िशन की वैल्यू "सही" है या "बायां".
y_position आइकॉन के सबसे ऊपर बाएं कोने की वर्टिकल पोज़िशन, वीडियो क्रिएटिव के सबसे ऊपरी बाएँ कोने में, पिक्सल में. यह फ़ील्ड रिस्पॉन्सिव पोज़िशन की वैल्यू "टॉप" या "निचले हिस्से" के तौर पर मार्क करें.
चौड़ाई आइकॉन की चौड़ाई, पिक्सल में.
ऊंचाई आइकॉन की ऊंचाई, पिक्सल में.
creative_type आइकॉन के लिए दी गई इमेज का mimetype. डिफ़ॉल्ट तौर पर, यह "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"
        }
        ...
      ]
      ...
    },
    ...
  }
  ...
}