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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

लक्ष्यीकरण

प्लैटफ़ॉर्म चुनें: iOS Unity Flutter Android (लेगसी)

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

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

एपीआई डेमो डाउनलोड करें

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

आगे बढ़ने से पहले, सेट अप करें 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 वही सेटिंग लागू करेगा जो सबसे ज़्यादा सुरक्षित है.

बच्चों के लिए सेटिंग

इंटरनेट पर बच्चों की निजता की सुरक्षा से जुड़े कानून (कोपा), के तहत, "बच्चों के लिए टैग" नाम की एक सेटिंग होती है. इस टैग को सेट करके, यह पक्का किया जाता है कि यह सूचना सही है और आपके पास ऐप्लिकेशन के मालिक की ओर से काम करने की अनुमति है. आपको यह भी समझना होगा कि इस सेटिंग का गलत इस्तेमाल करने पर, आपका Google खाता बंद किया जा सकता है.

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

setTagForChildDirectedTreatment() के ज़रिए, बच्चों के लिए सेटिंग लागू की जा सकती है:

यह बताने के लिए कि कोपा के तहत, आपके कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर माना जाए, setTagForChildDirectedTreatment को TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE के साथ कॉल करें. इससे, Android विज्ञापन आईडी (एएआईडी) का ट्रांसमिशन नहीं हो पाता.
यह बताने के लिए कि कोपा के तहत, आपके कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर न माना जाए, 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(), इसके लिए, ये विकल्प उपलब्ध हैं.

यह बताने के लिए कि विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही माना जाए जिनकी उम्र, सहमति देने की कानूनी उम्र से कम है, 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)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

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

Google Mobile Ads SDK (Legacy)

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

पब्लिशर की निजता से जुड़ा ट्रीटमेंट (पीपीटी) एपीआई, एक वैकल्पिक टूल है. इसकी मदद से, ऐप्लिकेशन यह तय कर सकते हैं कि सभी विज्ञापन अनुरोधों के लिए, लोगों की दिलचस्पी के हिसाब से विज्ञापन दिखाने की सुविधा बंद की जाए या नहीं.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