लक्ष्यीकरण

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

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

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

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 को बच्चों, किशोरों या किसी ऐसी उम्र के लिए विज्ञापन दिखाने से जुड़ी खास सुरक्षाएं लागू करनी चाहिए या नहीं जिसकी जानकारी नहीं है.

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 सबसे सुरक्षित सेटिंग लागू करता है.

मीडिएशन की मदद से, उम्र के हिसाब से विज्ञापन दिखाने की सेटिंग को फ़ॉरवर्ड करना

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

यहां दी गई टेबल में, मीडिएशन अडैप्टर के उन वर्शन की सूची दी गई है जो मीडिएट किए गए तीसरे पक्ष के एसडीके को, उम्र से जुड़ी पाबंदी वाले सिग्नल को फ़ॉरवर्ड करने की सुविधा देते हैं:

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

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

• TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE के साथ setTagForUnderAgeOfConsent() को कॉल करें. इससे यह पता चलता है कि आपको यूरोपियन इकनॉमिक एरिया (ईईए) में, सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए विज्ञापन दिखाने के अनुरोध को मैनेज करना है. इससे Android विज्ञापन के लिए आइडेंटिफ़ायर (AAID) को ट्रांसमिट होने से भी रोका जाता है.

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

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

विज्ञापन दिखाने के हर अनुरोध के लिए, सबसे ज़्यादा कॉन्टेंट रेटिंग सेट करने के बारे में ज़्यादा जानें.

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

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

कस्टम टारगेटिंग

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

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

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

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

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

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

श्रेणी बहिष्करण

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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() से अलग है. इसका इस्तेमाल सिर्फ़ ब्रैंड की सुरक्षा के लिए किया जाता है.