लक्ष्यीकरण

प्लैटफ़ॉर्म चुनें: Android 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)

Java

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

यह पक्का करने के लिए कि सभी विज्ञापन अनुरोधों पर, अनुरोध के कॉन्फ़िगरेशन में किए गए बदलाव लागू हों, अनुरोध का कॉन्फ़िगरेशन सेट करें इससे पहले कि आप शुरू करें 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)

Java

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

किशोरों या किसी ऐसी उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग सेट करने के लिए जिसकी जानकारी नहीं दी गई है, 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 टूल को फ़ॉरवर्ड करते हैं जिनके ज़रिए विज्ञापन दिखाए जाते हैं.

यहां दी गई टेबल में, मीडिएशन अडैप्टर के उन वर्शन की सूची दी गई है जो तीसरे पक्ष के उन 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)

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_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)

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);