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 Ad Manager 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 Ad Manager 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 एपीआई की मदद से, 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`

टीएफ़सीडी और टीएफ़यूए के साथ, उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग के इंटरैक्शन को समझना

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

बच्चों के लिए बनाए गए कॉन्टेंट की सेटिंग

इंटरनेट पर बच्चों की निजता की सुरक्षा से जुड़े कानून चिल्ड्रन्स ऑनलाइन प्राइवसी प्रोटेक्शन ऐक्ट (कोपा), के तहत, "बच्चों के लिए बनाए गए कॉन्टेंट के लिए टैग" नाम की एक सेटिंग होती है. इस टैग को सेट करके, यह पक्का किया जाता है कि यह सूचना सही है और आपके पास ऐप्लिकेशन के मालिक की ओर से काम करने की अनुमति है. आपको यह भी समझना होगा कि इस सेटिंग का गलत इस्तेमाल करने पर, आपका Google खाता बंद किया जा सकता है.

एक ऐप्लिकेशन डेवलपर के तौर पर कोई विज्ञापन अनुरोध करते समय, Google को यह बताया जा सकता है कि वह आपके कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर माने या नहीं. अगर आपने Google को यह बताया है कि वह आपके कॉन्टेंट को बच्चों के लिए बनाए गए कॉन्टेंट के तौर पर माने, तो हम उस विज्ञापन अनुरोध के लिए, दिलचस्पी के हिसाब से विज्ञापन और रीमार्केटिंग विज्ञापन बंद कर देते हैं.

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

कस्टम लक्ष्यीकरण

Google Ad Manager के कैंपेन (लाइन आइटम) को टारगेट करने के लिए, की-वैल्यू पेयर पास किए जा सकते हैं. यहां दिए गए उदाहरण में, विज्ञापन अनुरोध में की-वैल्यू पेयर पास किया गया है:

Kotlin

// Example: Pass custom targeting "age=25".
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build()

Java

// Example: Pass custom targeting "age=25".
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
  .putCustomTargeting("age", "25")
  .build();

किसी कुंजी के लिए, स्ट्रिंग की सूची के तौर पर एक से ज़्यादा वैल्यू पास की जा सकती हैं. उदाहरण के लिए, सिर्फ़ 25 साल के लोगों को टारगेट करने के बजाय, 20 से 29 साल के लोगों को टारगेट करना.

Kotlin

.putCustomTargeting("age", listOf("24", "25", "26"))

Java

.putCustomTargeting("age", Arrays.asList("24", "25", "26"));

कैटगरी एक्सक्लूज़न

`addCategoryExclusion()` तरीके का इस्तेमाल करके, किसी अनुरोध में स्लॉट-लेवल कैटगरी एक्सक्लूज़न लेवल जोड़ा जा सकता है:addCategoryExclusion()

Kotlin

// Example: Exclude "automobile" and "boat" categories.
val newRequest = AdRequest.Builder("AD_UNIT_ID")
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

Java

// Example: Exclude "automobile" and "boat" categories.
AdRequest newRequest = new AdRequest.Builder("AD_UNIT_ID")
    .addCategoryExclusion("automobile")
    .addCategoryExclusion("boat")
    .build();

Android API डेमो ऐप्लिकेशन में, कैटगरी एक्सक्लूज़न लागू करने का तरीका जानने के लिए, Ad Manager में कैटगरी एक्सक्लूज़न का उदाहरण देखें.

पब्लिशर के भेजे गए आईडी

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

पीपीआईडी सेट करने का उदाहरण यहां दिया गया है:

Kotlin

val adRequest = AdRequest.Builder("AD_UNIT_ID")
  .setPublisherProvidedId("AB123456789")
  .build()

Java

AdRequest adRequest = new AdRequest.Builder("AD_UNIT_ID")
    .setPublisherProvidedId("AB123456789")
    .build();

Android API डेमो ऐप्लिकेशन में, पब्लिशर के भेजे गए आईडी (पीपीआईडी) लागू करने का तरीका जानने के लिए, Ad Manager में पीपीआईडी का उदाहरण देखें.

पब्लिशर से मिले सिग्नल

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

Kotlin

val extras = Bundle()
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284))
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6))

val request = AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build()

Java

Bundle extras = new Bundle();
// Set the demographic to an audience with an "Age Range" of 30-34 and an
// interest in mergers and acquisitions.
extras.putIntegerArrayList("IAB_AUDIENCE_1_1", arrayListOf(6,284));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", arrayListOf(4,5,6));

AdRequest request = new AdRequest.Builder("AD_UNIT_ID")
  .setGoogleExtrasBundle(extras)
  .build();

कॉन्टेंट यूआरएल

कॉन्टेंट के हिसाब से टारगेट किए गए विज्ञापनों और ब्रैंड की सुरक्षा के लिए, कॉन्टेंट का यूआरएल देने के लिए, यह जानकारी जोड़ें:

Kotlin

val builder = AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com")
val request = builder.build()

Java

AdRequest.Builder builder = new AdRequest.Builder("AD_UNIT_ID")
builder.setContentUrl("https://www.example.com");
AdRequest request = builder.build();

ब्रैंड की सुरक्षा (बीटा वर्शन)

ऐसे ऐप्लिकेशन जो अलग-अलग ऑडियंस के लिए डाइनैमिक कॉन्टेंट दिखाते हैं, वे यूआरएल की एक छोटी सूची उपलब्ध करा सकते हैं:

Kotlin

val urls = mutableListOf("https://www.mycontenturl1.com", "https://www.mycontenturl2.com",
                         "https://www.mycontenturl3.com", "https://www.mycontenturl4.com")
val requestWithContent = AdRequest.Builder("AD_UNIT_ID")
  .setNeighboringContentUrls(urls)
  .build()

Java

ArrayList<String> urls = new ArrayList<String>();
urls.add("https://www.mycontenturl1.com");
urls.add("https://www.mycontenturl2.com");
urls.add("https://www.mycontenturl3.com");
urls.add("https://www.mycontenturl4.com");
AdRequest requestWithContent = new AdRequest.Builder("AD_UNIT_ID")
    .setNeighboringContentUrls(urls)
    .build();

.setNeighboringContentUrls() , .setContentUrl() से इस मामले में अलग है कि इसका इस्तेमाल सिर्फ़ ब्रैंड की सुरक्षा के लिए किया जाता है.