लक्ष्यीकरण

इस गाइड में किसी विज्ञापन अनुरोध के लिए टारगेटिंग की जानकारी देने का तरीका बताया गया है. उदाहरण के तौर पर, Android API डेमो ऐप्लिकेशन डाउनलोड करें.

एपीआई का डेमो डाउनलोड करें

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

RequestConfiguration

RequestConfiguration एक ऑब्जेक्ट है, जो टारगेटिंग की जानकारी इकट्ठा करके दुनिया भर में लागू करता है MobileAds स्टैटिक तरीका इस्तेमाल किया जाता है.

अनुरोध के कॉन्फ़िगरेशन को अपडेट करने के लिए, मौजूदा कॉन्फ़िगर करें, कोई भी मनचाहा अपडेट करें, और इसे नीचे दिए गए तरीके से सेट करें:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

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

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

इस सेटिंग का इस्तेमाल, Google Play services SDK के सभी वर्शन के साथ किया जा सकता है RequestConfiguration.Builder.setTagForChildDirectedTreatment(int) के ज़रिए:

  • setTagForChildDirectedTreatment को इससे कॉल करें TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE यह बताने के लिए कि आपको अपने कोपा का पालन करने के लिए बच्चों के लिए बना कॉन्टेंट. यह रोक लगाता है Android विज्ञापन आइडेंटिफ़ायर का ट्रांसमिशन (AAID).

  • setTagForChildDirectedTreatment को इससे कॉल करें TAG_FOR_CHILD_DIRECTED_TREATMENT_FALSE यह बताने के लिए कि आप अपने कोपा का पालन करने के लिए बच्चों के लिए बना कॉन्टेंट.

  • setTagForChildDirectedTreatment को इससे कॉल करें अगर आपको यह जानकारी नहीं देनी है, तो TAG_FOR_CHILD_DIRECTED_TREATMENT_UNSPECIFIED आपको विज्ञापन अनुरोधों में, कोपा का पालन करने के लिए अपने वीडियो के साथ किस तरह का व्यवहार करना है.

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

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForChildDirectedTreatment(RequestConfiguration.TAG_FOR_CHILD_DIRECTED_TREATMENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForChildDirectedTreatment(RequestConfiguration.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 का इस्तेमाल करके बताएं कि आपने यह बताया गया है कि विज्ञापन अनुरोध को सहमति देने की मान्य उम्र के तहत आने वाले यूरोपियन इकनॉमिक एरिया (ईईए) के लोगों के लिए.

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

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setTagForUnderAgeOfConsent(RequestConfiguration.TAG_FOR_UNDER_AGE_OF_CONSENT_TRUE)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setTagForUnderAgeOfConsent(RequestConfiguration.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 से ज़्यादा:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setMaxAdContentRating(RequestConfiguration.MAX_AD_CONTENT_RATING_G)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

इन विषयों के बारे में ज़्यादा जानें:

पब्लिशर की निजता नीति (बीटा वर्शन)

कॉन्टेंट बनाने पब्लिशर की निजता नीति (PPT) एपीआई एक ऐसा टूल है जो ज़रूरी नहीं है. इसकी मदद से, ऐप्लिकेशन यह बता सकते हैं कि विज्ञापन दिखाने की सुविधा बंद करनी है या नहीं का इस्तेमाल करके सभी विज्ञापन अनुरोधों के लिए, मनमुताबिक अनुभव पाने की सुविधा setPublisherPrivacyPersonalizationState() का तरीका. इस सुविधा का इस्तेमाल करते समय, पब्लिशर प्राइवसी ट्रीटमेंट (पीपीटी) पैरामीटर मौजूदा सेशन के लिए आने वाले समय के सभी विज्ञापन अनुरोधों में शामिल हो जाते हैं.

Google को भेजे जाने वाले विज्ञापन अनुरोधों को डिफ़ॉल्ट रूप से, दिलचस्पी के मुताबिक विज्ञापन दिखाए जाते हैं. नीचे दिए गए कोड सभी विज्ञापन अनुरोधों के लिए, दिलचस्पी के मुताबिक विज्ञापन दिखाने की सुविधा को बंद कर देता है:

Java

RequestConfiguration requestConfiguration = MobileAds.getRequestConfiguration()
    .toBuilder()
    .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
    .build();
MobileAds.setRequestConfiguration(requestConfiguration);

Kotlin

var requestConfiguration = MobileAds.getRequestConfiguration()
  .toBuilder()
  .setPublisherPrivacyPersonalizationState(PublisherPrivacyPersonalizationState.DISABLED)
  .build()
MobileAds.setRequestConfiguration(requestConfiguration)

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

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

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

आप Google Ad Manager अभियानों को लक्षित करने के लिए कस्टम की-वैल्यू पेयर पास कर सकते हैं (लाइन आइटम) से AdManagerAdRequest.Builder.addCustomTargeting() तक के लिए:

Java

// Example: Pass custom targeting "age=25".
AdManagerAdRequest newRequest = new AdManagerAdRequest.Builder()
    .addCustomTargeting("age", "25")
    .build();

Kotlin

// Example: Pass custom targeting "age=25".
var newRequest = AdManagerAdRequest.Builder()
  .addCustomTargeting("age", "25")
  .build()

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

.addCustomTargeting("age", Arrays.asList("24", "25", "26"))

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

किसी कैटगरी को बाहर रखना

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

Java

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

Kotlin

// Example: Exclude "automobile" and "boat" categories.
var newRequest = AdManagerAdRequest.Builder()
  .addCategoryExclusion("automobile")
  .addCategoryExclusion("boat")
  .build()

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

पब्लिशर से मिले आइडेंटिफ़ायर

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

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

Java

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

Kotlin

var adRequest = AdManagerAdRequest.Builder()
  .setPublisherProvidedId("AB123456789")
  .build()

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

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

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

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

AdManagerAdRequest request = new AdManagerAdRequest.Builder()
  .addNetworkExtrasBundle(AdMobAdapter.class, extras)
  .build()

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()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

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

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

Java

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

Kotlin

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

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

भिन्न ऑडियंस के लिए बनाई गई डायनामिक सामग्री दिखाने वाले ऐप्लिकेशन का इस्तेमाल करके यूआरएल की एक छोटी सूची दे सकते हैं setNeighboringContentUrls() AdManagerAdRequest बनाने का तरीका:

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");
AdManagerAdRequest requestWithContent = new AdManagerAdRequest.Builder()
    .setNeighboringContentUrls(urls)
    .build();

Kotlin

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

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