इस गाइड में, Google Mobile Ads SDK को टारगेटिंग की जानकारी देने का तरीका बताया गया है.
काम करने वाले उदाहरण के लिए, Android API Demo ऐप्लिकेशन डाउनलोड करें.पूर्वापेक्षा
जारी रखने से पहले, Google Mobile Ads SDK सेट अप करें.
RequestConfiguration
RequestConfiguration
हर विज्ञापन अनुरोध के लिए, दुनिया भर में लागू होने वाली टारगेटिंग की जानकारी इकट्ठा करता है. उपलब्ध टारगेटिंग टैग के लिए, RequestConfiguration.Builder दस्तावेज़ देखें.
अनुरोध के कॉन्फ़िगरेशन को अपडेट करने के लिए, मौजूदा कॉन्फ़िगरेशन से बिल्डर पाएं. इसके बाद, चुने गए अपडेट करें और इसे इस तरह सेट करें:
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);यह पक्का करने के लिए कि सभी विज्ञापन अनुरोधों पर, अनुरोध कॉन्फ़िगरेशन में किए गए बदलाव लागू हों, शुरू करने Google Mobile Ads SDK से पहले अनुरोध कॉन्फ़िगरेशन सेट करें.
उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग सेट करना
बच्चों और किशोरों से जुड़े निजता कानूनों का पालन करने में आपकी मदद करने के लिए, Google Mobile Ads SDK में उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग उपलब्ध है. इस सेटिंग की मदद से, यह तय किया जा सकता है कि Google Mobile Ads SDK को बच्चों, किशोरों या किसी ऐसी उम्र के लोगों के लिए विज्ञापन दिखाने से जुड़ी सुरक्षा की खास सुविधाएं लागू करनी चाहिए जिनकी उम्र के बारे में जानकारी नहीं है.
RequestConfiguration.Builder API की मदद से, setAgeRestrictedTreatment() तरीके का इस्तेमाल करके उम्र के हिसाब से ट्रीटमेंट सेट किया जा सकता है.
यहां दिए गए उदाहरण से पता चलता है कि विज्ञापन अनुरोधों को बच्चों की उम्र के हिसाब से मैनेज किया जाना चाहिए:
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);किशोरों की उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग या उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग के बारे में जानकारी न देने के लिए, CHILD सेटिंग को इससे बदलें:
TEENUNSPECIFIED
इस सेटिंग का इस्तेमाल करने पर, Google Mobile Ads SDK, विज्ञापन दिखाने के अनुरोधों में tfat पैरामीटर शामिल करता है. कानून और नियमों से जुड़ी ज़रूरी शर्तों के आधार पर, अपने उपयोगकर्ताओं के लिए उम्र के हिसाब से विज्ञापन दिखाए जाने की सेटिंग तय करने के लिए, अपने कानूनी सलाहकार से सलाह लें. ज़्यादा जानकारी के लिए, उम्र से जुड़ी पाबंदी के लिए, किसी ऐप्लिकेशन से किए जाने वाले विज्ञापन दिखाने के अनुरोध को टैग करना लेख पढ़ें.
टीएफ़सीडी और टीएफ़यूए से उम्र के हिसाब से विज्ञापन दिखाने की सुविधा पर माइग्रेट करना
उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग, अब काम न करने वाली .setTagForChildDirectedTreatment() (टीएफ़सीडी) और .setTagForUnderAgeOfConsent() (टीएफ़यूए) सेटिंग की जगह ले लेगी.
यहां दी गई टेबल में, टीएफ़सीडी और टीएफ़यूए सेटिंग और उम्र के हिसाब से विज्ञापन दिखाने की उनकी सेटिंग के बारे में बताया गया है:
TFCD
TFCD |
उम्र के हिसाब से विज्ञापन दिखाना |
|---|---|
TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE |
AgeRestrictedTreatment.CHILD |
TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE |
AgeRestrictedTreatment.UNSPECIFIED |
TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED |
AgeRestrictedTreatment.UNSPECIFIED |
.setTagForChildDirectedTreatment() एट्रिब्यूट के लिए कोई वैल्यू असाइन नहीं की गई है |
AgeRestrictedTreatment.UNSPECIFIED |
| कोई मिलती-जुलती रिपोर्ट नहीं | AgeRestrictedTreatment.TEEN |
TFUA
TFUA |
उम्र के हिसाब से ट्रीटमेंट |
|---|---|
TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE |
AgeRestrictedTreatment.CHILD |
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE |
AgeRestrictedTreatment.UNSPECIFIED |
TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED |
AgeRestrictedTreatment.UNSPECIFIED |
.setTagForUnderAgeOfConsent() एट्रिब्यूट के लिए कोई वैल्यू असाइन नहीं की गई है |
AgeRestrictedTreatment.UNSPECIFIED |
| कोई मिलती-जुलती रिपोर्ट नहीं | AgeRestrictedTreatment.TEEN |
टीएफ़सीडी और टीएफ़यूए के साथ उम्र के हिसाब से विज्ञापन दिखाने के लिए टैग (टीएफ़एटी) के इंटरैक्शन को समझना
अगर आपने उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग और टीएफ़सीडी या टीएफ़यूए सेटिंग सेट की हैं, तो Google सबसे सुरक्षित सेटिंग लागू करता है.
बच्चों के लिए बने कॉन्टेंट की सेटिंग
चिल्ड्रंस ऑनलाइन प्राइवसी प्रोटेक्शन ऐक्ट (कोपा) के तहत, "बच्चों को ध्यान में रखते हुए व्यवहार के लिए टैग करें" नाम की एक सेटिंग होती है. इस टैग को सेट करके, यह पुष्टि की जाती है कि यह सूचना सही है और आपको ऐप्लिकेशन के मालिक की ओर से काम करने की अनुमति है. आपको यह भी पता है कि इस सेटिंग का गलत इस्तेमाल करने से आपका Google खाता बंद हो सकता है.
ऐप्लिकेशन डेवलपर के तौर पर, विज्ञापन दिखाने का अनुरोध करते समय Google को यह बताया जा सकता है कि वह आपके कॉन्टेंट को बच्चों के लिए बनाए या नहीं. अगर आपने Google को यह बताया है कि वह आपके कॉन्टेंट को बच्चों के लिए बनाए, तो हम उस विज्ञापन अनुरोध पर आईबीए और रीमार्केटिंग विज्ञापन बंद करने के लिए ज़रूरी कदम उठाते हैं.
बच्चों के लिए बने कॉन्टेंट की सेटिंग को यहां से लागू किया जा सकता है
setTagForChildDirectedTreatment():
setTagForChildDirectedTreatmentकोTAG_FOR_CHILD_DIRECTED_TREATMENT_TRUEके साथ कॉल करें, ताकि यह पता चल सके कि आपको सीओपीपीए के मकसद से, अपने कॉन्टेंट को बच्चों के लिए लक्षित कॉन्टेंट के तौर पर टैग करना है. इससे Android विज्ञापन के लिए आइडेंटिफ़ायर (AAID) का ट्रांसमिशन रुक जाता है.setTagForChildDirectedTreatmentकोTAG_FOR_CHILD_DIRECTED_TREATMENT_FALSEके साथ कॉल करें, ताकि यह बताया जा सके कि आपको सीओपीपीए के मकसद के लिए, अपने कॉन्टेंट को बच्चों के लिए लक्षित नहीं मानना है.अगर आपको विज्ञापन अनुरोधों में कोपा के तहत, अपने कॉन्टेंट को किस तरह से मैनेज करना है, यह नहीं बताना है, तो
setTagForChildDirectedTreatmentकोTAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIEDके साथ कॉल करें.
इस उदाहरण से पता चलता है कि कोपा के तहत, आपको अपने कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर ट्रीट करना है:
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setTagForChildDirectedTreatment(
RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);सहमति देने की मान्य उम्र से कम के उपयोगकर्ता
आप सहमति देने की मान्य उम्र से कम उम्र के यूरोपियन इकनॉमिक एरिया (ईईए) के उपयोगकर्ताओं के लिए ट्रीटमेंट पाने के लिए अपने विज्ञापन दिखाने के अनुरोधों को मार्क कर सकते हैं. यह सुविधा जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) का पालन करने में मदद करती है. ध्यान दें कि जीडीपीआर के तहत, आपकी दूसरी कानूनी जवाबदेहियां हो सकती हैं. यूरोपीय संघ के दिशा-निर्देश देखें और अपने कानूनी सलाहकार से संपर्क करें. ध्यान दें कि Google के टूल, नियमों के पालन में मदद के लिए डिज़ाइन किए गए हैं. इन टूल से किसी भी पब्लिशर को यह छूट नहीं मिलती है कि वह अपनी कानूनी जवाबदेही की अनदेखी करे. पब्लिशर पर जीडीपीआर का क्या असर होता है, इस बारे में ज़्यादा जानें.
इस सुविधा का इस्तेमाल करने पर, विज्ञापन दिखाने के अनुरोध में 'यूरोप में सहमति देने की मान्य उम्र से कम वाले उपयोगकर्ताओं के लिए टैग' (टीएफ़यूए) पैरामीटर शामिल हो जाता है. यह पैरामीटर, विज्ञापन दिखाने के सभी अनुरोधों के लिए, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा बंद कर देता है. इसमें रीमार्केटिंग भी शामिल है. इससे, विज्ञापन की सेवा देने वाली तीसरे पक्ष की कंपनियों के अनुरोध भी बंद हो जाते हैं, जैसे कि विज्ञापन की परफ़ॉर्मेंस का आकलन करने वाले पिक्सल और तीसरे पक्ष के विज्ञापन सर्वर.
बच्चों के लिए बने कॉन्टेंट से जुड़ी सेटिंग की तरह ही, RequestConfiguration.Builder में टीएफ़यूए पैरामीटर सेट करने का तरीका है:
setTagForUnderAgeOfConsent(),
इन विकल्पों के साथ.
setTagForUnderAgeOfConsent()कोTAG_FOR_UNDER_AGE_OF_CONSENT_TRUEके साथ कॉल करें. इससे यह पता चलता है कि आपको विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही मानना है जिनकी उम्र सहमति देने की कानूनी उम्र से कम है. इससे Android विज्ञापन आईडी (एएआईडी) को ट्रांसफ़र होने से भी रोका जा सकता है.setTagForUnderAgeOfConsent()कोTAG_FOR_UNDER_AGE_OF_CONSENT_FALSEके साथ कॉल करें, ताकि यह पता चल सके कि आपको विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए नहीं मैनेज करना है जिनकी उम्र सहमति देने की कानूनी उम्र से कम है.setTagForUnderAgeOfConsent()कोTAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIEDके साथ कॉल करें. इससे यह पता चलता है कि आपने यह नहीं बताया है कि विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही माना जाए जिनकी उम्र सहमति देने की कानूनी उम्र से कम है.
इस उदाहरण से पता चलता है कि आपको विज्ञापन अनुरोधों में टीएफ़यूए शामिल करना है:
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);बच्चों के लिए बने कॉन्टेंट की सेटिंग और setTagForUnderAgeOfConsent() को चालू करने वाले टैग, दोनों को एक साथ true पर सेट नहीं किया जाना चाहिए. अगर ऐसा होता है, तो बच्चों के लिए बने कॉन्टेंट की सेटिंग को प्राथमिकता दी जाती है.
विज्ञापन के कॉन्टेंट को फ़िल्टर करना
Google Play की अनुचित विज्ञापनों को रोकने के लिए बनी नीति का पालन करने के लिए, यह ज़रूरी है कि आपके ऐप्लिकेशन में दिखाए जाने वाले सभी विज्ञापन और उनसे जुड़े ऑफ़र, आपके ऐप्लिकेशन की कॉन्टेंट रेटिंग के हिसाब से सही हों. इस नीति में, विज्ञापन में दिखाए जाने वाले ऑफ़र भी शामिल हैं. भले ही, उन विज्ञापनों और उनसे जुड़े ऑफ़र का कॉन्टेंट अपने-आप में Google Play की नीतियों का पालन सही तरीके से करता हो.
'विज्ञापन के लिए सबसे ज़्यादा रेटिंग' जैसे टूल की मदद से, उपयोगकर्ताओं को दिखाए जाने वाले विज्ञापनों के कॉन्टेंट पर ज़्यादा कंट्रोल हासिल किया जा सकता है. साथ ही, प्लैटफ़ॉर्म की नीतियों का पालन करने के लिए, सबसे ज़्यादा कॉन्टेंट रेटिंग सेट की जा सकती है.
ऐप्लिकेशन, setMaxAdContentRating तरीके का इस्तेमाल करके, विज्ञापन दिखाने के अनुरोधों के लिए विज्ञापन के कॉन्टेंट की ज़्यादा से ज़्यादा रेटिंग सेट कर सकते हैं. इस सेटिंग को कॉन्फ़िगर करने पर, AdMob से दिखाए जाने वाले विज्ञापनों की कॉन्टेंट रेटिंग, उस लेवल के बराबर या उससे कम होती है. इस नेटवर्क एक्स्ट्रा के लिए उपलब्ध वैल्यू, डिजिटल कॉन्टेंट लेबल के क्लासिफ़िकेशन पर आधारित होती हैं. साथ ही, इनमें से कोई एक स्ट्रिंग होनी चाहिए:
MAX_AD_CONTENT_RATING_GMAX_AD_CONTENT_RATING_PGMAX_AD_CONTENT_RATING_TMAX_AD_CONTENT_RATING_MA
यहां दिए गए कोड में, RequestConfiguration ऑब्जेक्ट को कॉन्फ़िगर किया गया है. इससे यह तय किया जाता है कि दिखाए जाने वाले विज्ञापन का कॉन्टेंट, G से ज़्यादा के डिजिटल कॉन्टेंट लेबल डेज़िग्नेशन से मेल नहीं खाना चाहिए:
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);इनके बारे में ज़्यादा जानें:
हर विज्ञापन अनुरोध के लिए, सबसे ज़्यादा कॉन्टेंट रेटिंग सेट करना
किसी ऐप्लिकेशन या खाते के लिए, 'विज्ञापन के लिए सबसे ज़्यादा रेटिंग' सेट करना
Publisher Privacy Treatment (Beta)
Publisher Privacy Treatment (पीपीटी) एपीआई एक वैकल्पिक टूल है. इसकी मदद से ऐप्लिकेशन यह तय कर सकते हैं कि setPublisherPrivacyPersonalizationState() तरीके का इस्तेमाल करके, सभी विज्ञापन अनुरोधों के लिए विज्ञापनों को निजी बनाने की सुविधा बंद करनी है या नहीं. इस सुविधा का इस्तेमाल करने पर, पब्लिशर की निजता से जुड़े डेटा को प्रोसेस करने के तरीके (पीपीटी) का पैरामीटर, सेशन के बाकी समय के लिए विज्ञापन के सभी अनुरोधों में शामिल हो जाता है.
डिफ़ॉल्ट रूप से, Google को भेजे जाने वाले विज्ञापन अनुरोधों के लिए, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाए जाते हैं. यहां दिया गया कोड, विज्ञापन दिखाने के सभी अनुरोधों के लिए, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा बंद कर देता है:
Kotlin
val requestConfiguration =
MobileAds.getRequestConfiguration()
.toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
.setPublisherPrivacyPersonalizationState(
RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);विज्ञापन अनुरोध
AdRequest ऑब्जेक्ट, टारगेटिंग की जानकारी इकट्ठा करता है, ताकि उसे विज्ञापन दिखाने के अनुरोध के साथ भेजा जा सके.
नेटवर्क की अतिरिक्त जानकारी जोड़ना
नेटवर्क एक्स्ट्रा, विज्ञापन दिखाने के अनुरोध के साथ भेजी गई अतिरिक्त जानकारी होती है. यह जानकारी, किसी एक विज्ञापन सोर्स के लिए खास होती है.
यहां दिया गया कोड स्निपेट, Google को collapsible की अतिरिक्त पैरामीटर कुंजी और bottom की वैल्यू सेट करता है:
Kotlin
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)Java
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);