लक्ष्यीकरण

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

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

आगे बढ़ने से पहले, सेट अप करें GMA Next-Gen SDK.

RequestConfiguration

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

बिल्डर का इस्तेमाल करके, अपनी ज़रूरत के हिसाब से टारगेटिंग टैग वाला RequestConfiguration ऑब्जेक्ट बनाएं. इसके बाद, MobileAds.setRequestConfiguration() को कॉल करके कॉन्फ़िगरेशन सेट करें.

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

पहले विज्ञापन दिखाने के अनुरोध से टारगेटिंग टैग लागू करने के लिए, SDK को शुरू करते समय अनुरोध का कॉन्फ़िगरेशन दें:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  // Set your targeting tags.
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

CoroutineScope(Dispatchers.IO).launch {
  // Initialize GMA Next-Gen SDK on a background thread.
  MobileAds.initialize(
    this@MainActivity,
    InitializationConfig
      // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
      .Builder("SAMPLE_APP_ID")
      .setRequestConfiguration(requestConfiguration)
      .build()
  ) {
    // Adapter initialization is complete.
  }
  // Other methods on MobileAds can now be called.
}

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
    .Builder()
    // Set your targeting tags.
    .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();

new Thread(
    () -> {
      // Initialize GMA Next-Gen SDK on a background thread.
      MobileAds.initialize(
          this,
          // Sample AdMob app ID: ca-app-pub-3940256099942544~3347511713
          new InitializationConfig
              .Builder("SAMPLE_APP_ID")
              .setRequestConfiguration(requestConfiguration)
              .build(),
          initializationStatus -> {
            // Adapter initialization is complete.
          });
      // Other methods on MobileAds can now be called.
    })
    .start();

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

बच्चों और किशोरों से जुड़ी निजता के लागू कानूनों का पालन करने में आपकी मदद करने के लिए, GMA Next-Gen SDK में उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग दी गई है. उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग की मदद से, यह बताया जा सकता है कि GMA Next-Gen SDK को बच्चों, किशोरों या किसी ऐसी उम्र के लिए विज्ञापन दिखाने की खास सुरक्षा लागू करनी चाहिए जिसके बारे में जानकारी नहीं दी गई है.

RequestConfiguration.Builder एपीआई के setAgeRestrictedTreatment() तरीके से, उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग सेट की जा सकती है.

यहां दिए गए उदाहरण से पता चलता है कि विज्ञापन अनुरोधों को बच्चों की उम्र के हिसाब से मैनेज किया जाना चाहिए:

Kotlin

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

Java

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

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

  • TEEN
  • UNSPECIFIED

इस सेटिंग का इस्तेमाल करने पर, GMA Next-Gen 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() के ज़रिए, बच्चों के लिए बनाए गए कॉन्टेंट की सेटिंग लागू की जा सकती है:

  • कोपा के तहत, अपने कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर दिखाने के लिए, TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE के साथ setTagForChildDirectedTreatment को कॉल करें. इससे, Android विज्ञापन के लिए आइडेंटिफ़ायर (एएआईडी) का ट्रांसमिशन नहीं होता.

  • कोपा के तहत, अपने कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर न दिखाने के लिए, TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE के साथ setTagForChildDirectedTreatment को कॉल करें.

  • अगर आपको यह नहीं बताना है कि विज्ञापन अनुरोधों में, कोपा के तहत अपने कॉन्टेंट को किस तरह से दिखाना है, तो TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED के साथ setTagForChildDirectedTreatment को कॉल करें.

यहां दिए गए उदाहरण से पता चलता है कि कोपा के तहत, अपने कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर दिखाना है:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(RequestConfiguration.TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForChildDirectedTreatment(TagForChildDirectedTreatment.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

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

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

  • अगर आपको यह बताना है कि विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही माना जाए जिनकी उम्र, सहमति देने की कानूनी उम्र से कम है, तो TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE के साथ setTagForUnderAgeOfConsent() को कॉल करें. इससे, Android विज्ञापन के लिए आइडेंटिफ़ायर (एएआईडी) का ट्रांसमिशन भी नहीं होता.

  • अगर आपको यह बताना है कि विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही नहीं माना जाए जिनकी उम्र, सहमति देने की कानूनी उम्र से कम है, तो TAG_FOR_UNDER_AGE_OF_CONSENT_FALSE के साथ setTagForUnderAgeOfConsent() को कॉल करें.

  • अगर आपको यह नहीं बताना है कि विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही माना जाए जिनकी उम्र, सहमति देने की कानूनी उम्र से कम है, तो TAG_FOR_UNDER_AGE_OF_CONSENT_UNSPECIFIED के साथ setTagForUnderAgeOfConsent() को कॉल करें.

यहां दिए गए उदाहरण से पता चलता है कि आपको अपने विज्ञापन अनुरोधों में टीएफ़यूए शामिल करना है:

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setTagForUnderAgeOfConsent(TagForUnderAgeOfConsent.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

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

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

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

ऐप्लिकेशन, `setMaxAdContentRating` तरीके का इस्तेमाल करके, अपने विज्ञापन अनुरोधों के लिए, 'विज्ञापन के लिए सबसे ज़्यादा रेटिंग' सेट कर सकते हैं.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 = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setMaxAdContentRating(MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

GMA Next-Gen SDK

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

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

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

Kotlin

val requestConfiguration = RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

Java

RequestConfiguration requestConfiguration = new RequestConfiguration
  .Builder()
  .setPublisherPrivacyPersonalizationState(RequestConfiguration.PublisherPrivacyPersonalizationState.DISABLED)
  .build();

MobileAds.setRequestConfiguration(requestConfiguration);

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

AdRequest ऑब्जेक्ट, टारगेटिंग की जानकारी इकट्ठा करता है, ताकि इसे विज्ञापन दिखाने के अनुरोध के साथ भेजा जा सके.

नेटवर्क एक्स्ट्रा जोड़ना

नेटवर्क एक्स्ट्रा, विज्ञापन दिखाने के अनुरोध के साथ भेजी जाने वाली अतिरिक्त जानकारी होती है. यह जानकारी, किसी एक विज्ञापन सोर्स के लिए खास होती है.

यहां दिए गए कोड स्निपेट में, Google के लिए, collapsible के अतिरिक्त पैरामीटर की कुंजी को bottom की वैल्यू के साथ सेट किया गया है:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  NativeAdRequest.Builder("AD_UNIT_ID", listOf(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build()
NativeAdLoader.load(adRequest, adCallback)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
NativeAdRequest adRequest =
  new NativeAdRequest.Builder("AD_UNIT_ID", Arrays.asList(NativeAd.NativeAdType.NATIVE))
    .setGoogleExtrasBundle(extras)
    .build();
NativeAdLoader.load(adRequest, adCallback);