Google Advertising and Measurement Community सर्वर के #gma-next-gen-sdk Discord चैनल में, GMA Next-Gen SDK के बारे में अपना सुझाव/राय दें या शिकायत करें.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

लक्ष्यीकरण

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

Java

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() (टीएफ़यूए) की उन सेटिंग की जगह लेती है जो अब काम नहीं करती हैं.

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

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

यह बताने के लिए कि कोपा के तहत, आपके कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर माना जाना चाहिए, setTagForChildDirectedTreatment को TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE के साथ कॉल करें. इससे, Android विज्ञापन आईडी (एएआईडी) ट्रांसमिट नहीं होता.
यह बताने के लिए कि कोपा के तहत, आपके कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर _नहीं_ माना जाना चाहिए, 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 विज्ञापन आईडी (एएआईडी) ट्रांसमिट नहीं होता.
यह बताने के लिए कि विज्ञापन अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) के उन उपयोगकर्ताओं के लिए सही नहीं माना जाना चाहिए जिनकी उम्र, सहमति देने की कानूनी उम्र से कम है, 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);