इस गाइड में, 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 को बच्चों या किशोरों को ध्यान में रखकर बनाए जाने वाले विज्ञापनों से जुड़ी सुरक्षा नीति लागू करनी चाहिए या नहीं. इस सेटिंग का इस्तेमाल करने पर,
Google Mobile Ads SDK, विज्ञापन अनुरोधों में tfat पैरामीटर शामिल करता है. अपने कानूनी सलाहकार से सलाह लें. इससे आपको यह तय करने में मदद मिलेगी कि कानूनी और नियामक शर्तों के आधार पर, आपके उपयोगकर्ताओं के लिए उम्र के हिसाब से कौनसी सेटिंग लागू की जानी चाहिए.
RequestConfiguration.Builder API की मदद से, setAgeRestrictedTreatment() तरीके का इस्तेमाल करके उम्र के हिसाब से विज्ञापन दिखाने की सुविधा सेट की जा सकती है.
बच्चे की उम्र के हिसाब से कॉन्टेंट दिखाने की सुविधा सेट अप करना
यहां दिए गए उदाहरण से पता चलता है कि विज्ञापन अनुरोधों को बच्चों की उम्र के हिसाब से ट्रीट किया जाना चाहिए:
Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have child age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
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 teen age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have teen age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
उम्र के हिसाब से कोई खास पाबंदी सेट न करना
यहां दिए गए उदाहरण से पता चलता है कि विज्ञापन अनुरोधों को उम्र के हिसाब से कोई खास ट्रीटमेंट नहीं मिलना चाहिए:
Java
RequestConfiguration requestConfiguration =
MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have unspecified age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
.build();
MobileAds.setRequestConfiguration(requestConfiguration);
Kotlin
val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
// Indicate that ad requests should have unspecified age treatment.
.setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
.build()
MobileAds.setRequestConfiguration(requestConfiguration)
टीएफ़सीडी और टीएफ़यूए से, उम्र के हिसाब से विज्ञापन दिखाने की सुविधा पर माइग्रेट करना
उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग, अब काम न करने वाली .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);इनके बारे में ज़्यादा जानें:
हर विज्ञापन अनुरोध के लिए, सबसे ज़्यादा कॉन्टेंट रेटिंग सेट करना
किसी ऐप्लिकेशन या खाते के लिए, 'विज्ञापन के लिए सबसे ज़्यादा रेटिंग' सेट करना
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);