लक्ष्यीकरण

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

विज्ञापन के पहले अनुरोध से टारगेटिंग टैग लागू करने के लिए, एसडीके शुरू करने के दौरान अनुरोध कॉन्फ़िगरेशन दें:

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 को बच्चों या किशोरों को ध्यान में रखकर बनाए जाने वाले विज्ञापनों से जुड़ी सुरक्षा नीति लागू करनी चाहिए या नहीं. इस सेटिंग का इस्तेमाल करने पर, GMA Next-Gen SDK, विज्ञापन अनुरोधों में tfat पैरामीटर शामिल करता है. अपने कानूनी सलाहकार से सलाह लें. इससे आपको यह तय करने में मदद मिलेगी कि कानूनी और नियामक शर्तों के आधार पर, आपके उपयोगकर्ताओं के लिए उम्र के हिसाब से कौनसी सेटिंग लागू की जानी चाहिए.

RequestConfiguration.Builder API की मदद से, 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);

किशोरों के लिए इलाज की सेटिंग सेट करना

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have teenage treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.TEEN)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

उम्र के हिसाब से कोई खास पाबंदी सेट न करना

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration().toBuilder()
    // Indicate that ad requests should have unspecified age treatment.
    .setAgeRestrictedTreatment(AgeRestrictedTreatment.UNSPECIFIED)
    .build()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

टीएफ़सीडी और टीएफ़यूए से, उम्र के हिसाब से विज्ञापन दिखाने की सुविधा पर माइग्रेट करना

उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग, अब काम न करने वाली .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

TFCD और TFUA के साथ उम्र के हिसाब से विज्ञापन दिखाने की सुविधा के इंटरैक्शन के बारे में जानकारी

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

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

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

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

Publisher Privacy Treatment (Beta)

Publisher Privacy Treatment (पीपीटी) एपीआई एक वैकल्पिक टूल है. इसकी मदद से ऐप्लिकेशन यह तय कर सकते हैं कि 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);