इस गाइड में, Google Mobile Ads SDK को टारगेटिंग की जानकारी देने का तरीका बताया गया है.
काम करने वाले उदाहरण के लिए, Android API डेमो ऐप्लिकेशन डाउनलोड करें.पूर्वापेक्षा
आगे बढ़ने से पहले, सेट अप करें 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 उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग की मदद से, यह बताया जा सकता है कि Google Mobile Ads SDK को बच्चों, किशोरों या किसी ऐसी उम्र के लिए विज्ञापन दिखाने की खास सुरक्षा सेटिंग लागू करनी चाहिए जिसकी जानकारी नहीं दी गई है.
RequestConfiguration.Builder
एपीआई के साथ, 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 विज्ञापन के लिए आइडेंटिफ़ायर (AAID) भी ट्रांसमिट नहीं होता.यह बताने के लिए कि विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही नहीं माना जाए जिनकी उम्र, सहमति देने की कानूनी उम्र से कम है,
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);इनके बारे में ज़्यादा जानें:
हर विज्ञापन अनुरोध के लिए, सबसे ज़्यादा कॉन्टेंट रेटिंग सेट करना
किसी ऐप्लिकेशन या खाते के लिए, विज्ञापन के कॉन्टेंट की सबसे ज़्यादा रेटिंग सेट करना
पब्लिशर की निजता से जुड़ा मैनेजमेंट (पीपीटी) एपीआई (बीटा)
पब्लिशर की निजता से जुड़ा मैनेजमेंट (पीपीटी) एपीआई, एक वैकल्पिक टूल है. इसकी मदद से, ऐप्लिकेशन यह तय कर सकते हैं कि सभी विज्ञापन अनुरोधों के लिए, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा बंद करनी है या नहीं.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);