लक्ष्यीकरण

इस गाइड में, 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();

बच्चों को ध्यान में रखते हुए सेटिंग

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

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

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

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

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