लक्ष्यीकरण

इस गाइड में किसी विज्ञापन अनुरोध में टारगेटिंग की जानकारी देने का तरीका बताया गया है. काम करने वाले उदाहरण के लिए, 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 और रीमार्केटिंग विज्ञापनों को बंद करने के लिए कदम उठाते हैं.

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

  • 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 ऑब्जेक्ट, टारगेटिंग (विज्ञापन के लिए सही दर्शक चुनना) की जानकारी इकट्ठा करता है, जो विज्ञापन अनुरोध के साथ भेजी जाती है.

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

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

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

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

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

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

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

पब्लिशर के भेजे गए आइडेंटिफ़ायर

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

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

Java

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

Kotlin

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

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

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

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

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

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

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