लक्ष्यीकरण

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

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

जारी रखने से पहले, GMA Next-Gen SDK सेट अप करें.

RequestConfiguration

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

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

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

MobileAds.setRequestConfiguration(requestConfiguration)

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

MobileAds.setRequestConfiguration(requestConfiguration);

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

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.
}

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

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

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

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

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

• TEEN
• UNSPECIFIED

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

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

उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग, अब काम न करने वाली .setTagForChildDirectedTreatment() (टीएफ़सीडी) और .setTagForUnderAgeOfConsent() (टीएफ़यूए) सेटिंग की जगह ले लेगी.

यहां दी गई टेबल में, टीएफ़सीडी और टीएफ़यूए सेटिंग और उम्र के हिसाब से विज्ञापन दिखाने की उनकी सेटिंग के बारे में बताया गया है:

टीएफ़सीडी और टीएफ़यूए के साथ उम्र के हिसाब से ट्रीटमेंट के इंटरैक्शन को समझना

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

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

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

MobileAds.setRequestConfiguration(requestConfiguration)

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 विज्ञापन आईडी (एएआईडी) को ट्रांसफ़र होने से भी रोका जा सकता है.

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

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

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

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

MobileAds.setRequestConfiguration(requestConfiguration)

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 से ज़्यादा नहीं होना चाहिए:

val requestConfiguration = RequestConfiguration
  .Builder()
  .setMaxAdContentRating(RequestConfiguration.MaxAdContentRating.MAX_AD_CONTENT_RATING_G)
  .build()

MobileAds.setRequestConfiguration(requestConfiguration)

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 को भेजे जाने वाले विज्ञापन अनुरोधों के लिए, लोगों की दिलचस्पी के मुताबिक दिखाए जाने वाले विज्ञापन दिखाए जाते हैं. यहां दिया गया कोड, विज्ञापन दिखाने के सभी अनुरोधों के लिए, लोगों की दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा बंद कर देता है:

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

MobileAds.setRequestConfiguration(requestConfiguration)

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

MobileAds.setRequestConfiguration(requestConfiguration);

विज्ञापन अनुरोध

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

नेटवर्क की अतिरिक्त जानकारी जोड़ना

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

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

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)

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