Google के होस्ट किए गए, दिलचस्पी के मुताबिक विज्ञापन दिखाने वाले सभी ऐप्लिकेशन को, AdChoices आइकॉन और ओवरले लागू करना होगा. हालांकि, ऐसा तब ही करना होगा, जब Google ने उन्हें उपलब्ध कराया हो. AdChoices (इसे "यह विज्ञापन क्यों?" भी कहा जाता है) एक पारदर्शिता सुविधा है, जो उपयोगकर्ताओं को बताती है कि उन्हें विज्ञापन के साथ-साथ यह जानकारी भी देती है कि उनकी निजता की सुरक्षा कैसे की जाती है.
ज़्यादा जानकारी के लिए, आपको विज्ञापन क्यों दिख रहा है लेख पढ़ें.
इस गाइड में, अपने विज्ञापन के VAST एक्सएमएल रिस्पॉन्स या अपनी डीएआई स्ट्रीम के मेटाडेटा रिस्पॉन्स से, AdChoices को सही तरीके से लागू करने के लिए ज़रूरी जानकारी निकालने का तरीका बताया गया है.
AdChoices रेंडरिंग के लिए ज़रूरी शर्तें
AdChoices आइकॉन रेंडर करने के लिए, Google की ज़रूरी शर्तों का पालन करने के लिए, आपके ऐप्लिकेशन या वेबसाइट को इन स्टैंडर्ड का पालन करना होगा:
- AdChoices आइकॉन उस विज्ञापन को ओवरले करते हुए दिखना चाहिए जिसके लिए यह दिया गया
- AdChoices आइकॉन, "X" से दिखाई गई जगह पर दिखना चाहिए जगह" और "Y स्थान" प्रॉपर्टी आइकॉन डेटा में और डेंसिटी-इंडिपेंडेंट में चौड़ाई और ऊंचाई की प्रॉपर्टी के हिसाब से तय किया गया साइज़ पिक्सल (डीपी).
- AdChoices आइकॉन को दूसरे विज्ञापन ओवरले या इंटरफ़ेस एलिमेंट से छिपाया नहीं जाना चाहिए.
- जिन प्लैटफ़ॉर्म पर क्लिक करने की सुविधा या इनके जैसी कोई सुविधा मिलती है (उदाहरण के लिए, टच या रिमोट से चुनने के लिए), यह ज़रूरी है कि AdChoices आइकॉन क्लिक करने लायक हों.
- जिन प्लैटफ़ॉर्म पर ब्राउज़र काम करता है उन पर AdChoices आइकॉन पर क्लिक करने से, "ClickThrough" या "click_data" प्रॉपर्टी में दिए गए यूआरएल वाला ब्राउज़र टैब या विंडो खुलनी चाहिए.
- जिन प्लैटफ़ॉर्म पर ब्राउज़र काम नहीं करता उन पर AdChoices आइकॉन पर क्लिक करने से, एक मॉडल ओवरले खुलना चाहिए. इसमें "IconClickFallbackImage" या "click_fallback_images" प्रॉपर्टी में बताई गई इमेज में से कोई एक इमेज दिखनी चाहिए.
- जिन प्लैटफ़ॉर्म पर ब्राउज़र काम नहीं करता है उन पर फ़ॉलबैक इमेज को यहां दिखाया जाना चाहिए "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"
}
...
]
...
},
...
}
...
}