लक्ष्यीकरण

प्लैटफ़ॉर्म चुनें: Android iOS Unity Flutter

इस गाइड में, Google Mobile Ads SDK को टारगेटिंग की जानकारी देने का तरीका बताया गया है.

काम करने वाले उदाहरण के लिए, Android API डेमो ऐप्लिकेशन डाउनलोड करें.

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

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

आगे बढ़ने से पहले, सेट अप करें Google Mobile Ads SDK.

RequestConfiguration

RequestConfiguration , हर विज्ञापन अनुरोध पर दुनिया भर में लागू होने वाली टारगेटिंग की जानकारी इकट्ठा करता है. टारगेटिंग के लिए उपलब्ध टैग देखने के लिए, का दस्तावेज़ देखें.RequestConfiguration.Builder

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

Kotlin

val requestConfiguration = MobileAds.getRequestConfiguration()
MobileAds.setRequestConfiguration(requestConfiguration)

Java

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

यह पक्का करने के लिए कि सभी विज्ञापन अनुरोधों पर, अनुरोध के कॉन्फ़िगरेशन में किए गए बदलाव लागू हों, अनुरोध का कॉन्फ़िगरेशन सेट करें इससे पहले कि आप शुरू करें Google Mobile Ads 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 के साथ कॉल करें.

यहां दिए गए उदाहरण से पता चलता है कि कोपा के तहत, आपके कॉन्टेंट को बच्चों को ध्यान में रखते हुए बनाए गए कॉन्टेंट के तौर पर माना जाए:

Kotlin

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

Java

RequestConfiguration 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 के साथ कॉल करें.

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

Kotlin

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

Java

RequestConfiguration 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 से ज़्यादा डिजिटल कॉन्टेंट लेबल डेसिग्नेशन के हिसाब से न हो:

Kotlin

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

Java

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

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

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

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

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

Kotlin

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

Java

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

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

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

नेटवर्क एक्स्ट्रा जोड़ना

नेटवर्क एक्स्ट्रा, विज्ञापन अनुरोध के साथ भेजी जाने वाली अतिरिक्त जानकारी होती है. यह जानकारी, किसी एक विज्ञापन सोर्स के लिए खास होती है.

यहां दिए गए कोड स्निपेट में, Google के लिए, collapsible के अतिरिक्त पैरामीटर की कुंजी को bottom की वैल्यू के साथ सेट किया गया है:

Kotlin

val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest =
  AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, extras).build()
adView.loadAd(adRequest)

Java

Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest =
    new AdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter.class, extras).build();
adView.loadAd(adRequest);

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

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

Kotlin

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

Java

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

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

Kotlin

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

Java

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

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

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

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

Kotlin

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

Java

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

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

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

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

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

Kotlin

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

Java

AdManagerAdRequest adRequest =
    new AdManagerAdRequest.Builder().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 =
  AdManagerAdRequest.Builder().addNetworkExtrasBundle(AdMobAdapter::class.java, 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", new ArrayList<>(Arrays.asList(6, 284)));
// Set the content to sedan, station wagon and SUV automotive values.
extras.putIntegerArrayList("IAB_CONTENT_2_2", new ArrayList<>(Arrays.asList(4, 5, 6)));

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

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

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

Kotlin

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

Java

AdManagerAdRequest.Builder builder = new AdManagerAdRequest.Builder();
builder.setContentUrl("https://www.example.com");
AdManagerAdRequest 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 = AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build()

Java

List<String> urls =
    Arrays.asList(
        "https://www.mycontenturl1.com",
        "https://www.mycontenturl2.com",
        "https://www.mycontenturl3.com",
        "https://www.mycontenturl4.com");

AdManagerAdRequest requestWithContent =
    new AdManagerAdRequest.Builder().setNeighboringContentUrls(urls).build();

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