Google Mobile Ads SDK, रखरखाव मोड में है. नए अपडेट और सुविधाओं के लिए, migrate और सेट अप करें.

Google आपकी पसंदीदा भाषा में कॉन्टेंट का अनुवाद करने के लिए, एआई टेक्नोलॉजी का इस्तेमाल करता है. एआई से मिले अनुवादों में गलतियां हो सकती हैं.

लक्ष्यीकरण

इस गाइड में, Google Mobile Ads SDK को टारगेटिंग की जानकारी देने का तरीका बताया गया है.

उदाहरण के लिए, Android API Demo ऐप्लिकेशन डाउनलोड करें.

Download API Demo

पूर्वापेक्षा

जारी रखने से पहले, Google Mobile Ads SDK (Legacy) सेट अप करें.

RequestConfiguration

RequestConfiguration विज्ञापन दिखाने के हर अनुरोध पर, दुनिया भर में लागू की गई टारगेटिंग की जानकारी इकट्ठा करता है. टारगेटिंग के लिए उपलब्ध टैग के बारे में जानने के लिए, RequestConfiguration.Builder दस्तावेज़ देखें.

अनुरोध के कॉन्फ़िगरेशन को अपडेट करने के लिए, मौजूदा कॉन्फ़िगरेशन से बिल्डर पाएं. इसके बाद, चुने गए अपडेट करें और उसे इस तरह सेट करें:

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

यह पक्का करने के लिए कि विज्ञापन के सभी अनुरोधों पर, अनुरोध के कॉन्फ़िगरेशन में किए गए बदलाव लागू हों, Google Mobile Ads SDK (Legacy) को शुरू करने से पहले, अनुरोध का कॉन्फ़िगरेशन सेट करें.

उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग सेट करना

बच्चों और किशोरों से जुड़े निजता कानूनों का पालन करने में आपकी मदद करने के लिए, Google Mobile Ads SDK (Legacy) में उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग उपलब्ध है. उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग से यह तय किया जा सकता है कि Google Mobile Ads SDK (Legacy) को बच्चों, किशोरों या किसी ऐसी उम्र के लिए विज्ञापन दिखाने से जुड़ी खास सुरक्षाएं लागू करनी चाहिए या नहीं जिसकी जानकारी नहीं है.

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)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        // Indicate that ad requests should have child age treatment.
        .setAgeRestrictedTreatment(AgeRestrictedTreatment.CHILD)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

किशोरों या किसी अन्य उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग को सेट करने के लिए, CHILD सेटिंग को इससे बदलें:

TEEN
UNSPECIFIED

इस सेटिंग का इस्तेमाल करने पर, Google Mobile Ads SDK (Legacy) विज्ञापन अनुरोधों में 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 सबसे सुरक्षित सेटिंग लागू करता है.

AdMob मीडिएशन (अलग-अलग नेटवर्क से विज्ञापन दिखाना) की मदद से, उम्र से जुड़ी पाबंदी के आधार पर विज्ञापन दिखाने की सेटिंग को फ़ॉरवर्ड करना

अगर आपने Google Mobile Ads SDK (Legacy) का इस्तेमाल करके, उम्र के हिसाब से विज्ञापन दिखाने की सुविधा सेट की है, तो मीडिएशन अडैप्टर, उम्र के हिसाब से विज्ञापन दिखाने के सिग्नल को मीडिएशन वाले तीसरे पक्ष के SDK टूल को भेजते हैं.

यहां दी गई टेबल में, मीडिएशन अडैप्टर के उन वर्शन की सूची दी गई है जो मीडिएट किए गए तीसरे पक्ष के एसडीके को, उम्र से जुड़ी पाबंदी वाले सिग्नल को फ़ॉरवर्ड करने की सुविधा देते हैं:

मीडिएशन अडैप्टर का नाम	कम से कम इस वर्शन का होना ज़रूरी है
AppLovin	13.6.3.0
BidMachine	3.7.1.1
Bigo	5.9.0.1
Chartboost	9.12.1.1
DTExchange (Fyber)	8.4.5.1
i-mobile	2.3.2.4
InMobi	11.3.0.1
IronSource	9.4.3.0
Liftoff Monetize (Vungle)	7.7.4.2
LY (Line)	3.1.1.1
maio	2.0.9.0
Meta (Facebook)	6.21.0.4
Mintegral	17.1.61.1
Moloco	4.10.0.0
MyTarget	5.47.1.1
Pangle	8.1.0.3.1
PubMatic	5.1.2.2
Verve	3.9.0.0

बच्चों के लिए बनाए गए कॉन्टेंट की सेटिंग

चिल्ड्रंस ऑनलाइन प्राइवसी प्रोटेक्शन ऐक्ट (कोपा) के तहत, "बच्चों को ध्यान में रखते हुए व्यवहार करने के लिए टैग करें" नाम की एक सेटिंग है. इस टैग को सेट करके, आपने यह प्रमाणित किया है कि यह सूचना सही है और आपके पास ऐप्लिकेशन के मालिक की ओर से कार्रवाई करने की अनुमति है. आपको पता है कि इस सेटिंग का गलत इस्तेमाल करने पर, आपका 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)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForChildDirectedTreatment(
            RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

सहमति देने की मान्य उम्र से कम के उपयोगकर्ता

यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले, सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए, विज्ञापन दिखाने के अनुरोधों को मार्क किया जा सकता है. इस सुविधा का मकसद, जनरल डेटा प्रोटेक्शन रेगुलेशन (जीडीपीआर) का पालन करने में मदद करना है. जीडीपीआर के तहत, आपकी अन्य कानूनी जवाबदेही भी हो सकती हैं. यूरोपियन यूनियन के दिशा-निर्देशों की समीक्षा करें और अपने कानूनी सलाहकार से संपर्क करें. Google के टूल, नियमों के पालन में मदद के लिए डिज़ाइन किए गए हैं. इन टूल से किसी भी पब्लिशर को यह छूट नहीं मिलती है कि वह अपनी कानूनी जवाबदेही की अनदेखी करे. पब्लिशर पर जीडीपीआर का क्या असर होता है, इस बारे में ज़्यादा जानें.

इस सुविधा का इस्तेमाल करने पर, विज्ञापन दिखाने के अनुरोध में यूरोप में सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए बना टैग (टीएफ़यूए) पैरामीटर शामिल हो जाता है. यह पैरामीटर, विज्ञापन दिखाने के सभी अनुरोधों के लिए, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने के साथ-साथ रीमार्केटिंग पर भी रोक लगा देता है. इससे, विज्ञापन की सेवा देने वाली तीसरे पक्ष की कंपनियों के अनुरोध भी बंद हो जाते हैं, जैसे कि विज्ञापन की परफ़ॉर्मेंस का आकलन करने वाले पिक्सल और तीसरे पक्ष के विज्ञापन सर्वर.

बच्चों को ध्यान में रखकर बनाए गए कॉन्टेंट के लिए सेटिंग की तरह ही, RequestConfiguration.Builder में टीएफ़यूए पैरामीटर सेट करने का एक तरीका है: setTagForUnderAgeOfConsent(), इसमें ये विकल्प होते हैं.

TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE के साथ setTagForUnderAgeOfConsent() को कॉल करें. इससे यह पता चलता है कि आपको यूरोपियन इकनॉमिक एरिया (ईईए) में, सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए विज्ञापन दिखाने के अनुरोध को मैनेज करना है. इससे Android विज्ञापन के लिए आइडेंटिफ़ायर (AAID) को ट्रांसमिट होने से भी रोका जाता है.
TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE के साथ setTagForUnderAgeOfConsent() को कॉल करें. इससे यह पता चलता है कि आपको यूरोपियन इकनॉमिक एरिया (ईईए) में, सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए, विज्ञापन दिखाने का अनुरोध को प्रोसेस नहीं करना है.
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)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

बच्चों के लिए बनी सेटिंग और setTagForUnderAgeOfConsent() को चालू करने वाले टैग, दोनों को एक साथ true पर सेट नहीं किया जाना चाहिए. अगर ऐसा होता है, तो बच्चों के लिए बनी सेटिंग को प्राथमिकता दी जाती है.

विज्ञापन के कॉन्टेंट को फ़िल्टर करने की सुविधा

Google Play की आपत्तिजनक विज्ञापनों की रोकथाम के लिए बनी नीति का पालन करने के लिए, आपके ऐप्लिकेशन में दिखाए जाने वाले सभी विज्ञापन और उनसे जुड़े ऑफ़र, आपके ऐप्लिकेशन की कॉन्टेंट रेटिंग के हिसाब से सही होने चाहिए. भले ही, उन विज्ञापनों और उनसे जुड़े ऑफ़र का कॉन्टेंट अपने-आप में Google Play की नीतियों का पालन सही तरीके से करता हो. इस नीति में, विज्ञापन में मौजूद ऑफ़र भी शामिल हैं.

'विज्ञापन के लिए सबसे ज़्यादा रेटिंग' जैसे टूल की मदद से, उपयोगकर्ताओं को दिखाए जाने वाले विज्ञापनों के कॉन्टेंट पर ज़्यादा कंट्रोल हासिल किया जा सकता है. साथ ही, प्लैटफ़ॉर्म की नीतियों का पालन करने के लिए, सबसे ज़्यादा कॉन्टेंट रेटिंग सेट की जा सकती है.

ऐप्लिकेशन, विज्ञापन दिखाने के अनुरोधों के लिए, 'विज्ञापन के लिए सबसे ज़्यादा रेटिंग' सेट कर सकते हैं. इसके लिए, उन्हें setMaxAdContentRating तरीके का इस्तेमाल करना होगा. इसे कॉन्फ़िगर करने पर, AdMob से मिलने वाले विज्ञापनों की कॉन्टेंट रेटिंग, इस लेवल के बराबर या इससे कम होती है. इस अतिरिक्त जानकारी के लिए संभावित वैल्यू, डिजिटल कॉन्टेंट लेबल के क्लासिफ़िकेशन पर आधारित होती हैं. साथ ही, यह इनमें से कोई एक स्ट्रिंग होनी चाहिए:

MAX_AD_CONTENT_RATING_G
MAX_AD_CONTENT_RATING_PG
MAX_AD_CONTENT_RATING_T
MAX_AD_CONTENT_RATING_MA

यहां दिया गया कोड, RequestConfiguration ऑब्जेक्ट को कॉन्फ़िगर करता है. इससे यह तय होता है कि विज्ञापन का कॉन्टेंट, डिजिटल कॉन्टेंट लेबल के डेज़िग्नेशन के मुताबिक होना चाहिए. यह डेज़िग्नेशन, G से ज़्यादा नहीं होना चाहिए:

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

इनके बारे में ज़्यादा जानें:

पब्लिशर के लिए निजता से जुड़ा ट्रीटमेंट (बीटा वर्शन)

पब्लिशर प्राइवसी ट्रीटमेंट (पीपीटी) एपीआई एक वैकल्पिक टूल है. इसकी मदद से, ऐप्लिकेशन यह बता सकते हैं कि विज्ञापन दिखाने के सभी अनुरोधों के लिए, दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा बंद करनी है या नहीं. इसके लिए, setPublisherPrivacyPersonalizationState() तरीके का इस्तेमाल किया जाता है. इस सुविधा का इस्तेमाल करने पर, सेशन के बाकी हिस्से के लिए आने वाले सभी विज्ञापन दिखाने के अनुरोधों में, पब्लिशर प्राइवसी ट्रीटमेंट (पीपीटी) पैरामीटर शामिल किया जाता है.

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

Kotlin

val requestConfiguration =
  MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(
      RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED
    )
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)RequestConfigurationSnippets.kt

Java

RequestConfiguration requestConfiguration =
    MobileAds.getRequestConfiguration().toBuilder()
        .setPublisherPrivacyPersonalizationState(
            RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
        .build();
MobileAds.setRequestConfiguration(requestConfiguration);RequestConfigurationSnippets.java

विज्ञापन दिखाने का अनुरोध

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)AdRequestSnippets.kt

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);AdRequestSnippets.java