लक्ष्यीकरण

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

इस गाइड में, विज्ञापन अनुरोध को टारगेटिंग की जानकारी देने का तरीका बताया गया है.

विज्ञापन टारगेटिंग की सुविधा को आज़माने के लिए, iOS API Demo ऐप्लिकेशन को Swift या Objective-C में डाउनलोड करें.

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

ज़रूरी शर्तें

शुरुआती निर्देश वाली गाइड को पूरा करें.

GADRequestConfiguration

GADRequestConfiguration एक ऐसा ऑब्जेक्ट है जो टारगेटिंग की जानकारी इकट्ठा करता है, ताकि इसे GADMobileAds शेयर किए गए इंस्टेंस के ज़रिए, दुनिया भर में लागू किया जा सके. इसे इस कोड से ऐक्सेस किया जा सकता है:

Swift

let requestConfiguration = MobileAds.shared.requestConfiguration

Objective-C

GADRequestConfiguration requestConfiguration = GADMobileAds.sharedInstance.requestConfiguration;

यह पक्का करने के लिए कि विज्ञापन के सभी अनुरोधों पर, अनुरोध कॉन्फ़िगरेशन में किए गए बदलाव लागू हों, Mobile Ads SDK टूल का इस्तेमाल शुरू करने से पहले, अनुरोध कॉन्फ़िगरेशन सेट करें.

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

चिल्ड्रंस ऑनलाइन प्राइवसी प्रोटेक्शन ऐक्ट (कोपा) के तहत, tagForChildDirectedTreatment नाम की एक सेटिंग होती है.

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

  • tagForChildDirectedTreatment को true पर सेट करें. इससे यह पता चलेगा कि आपको सीओपीपीए के तहत, अपने कॉन्टेंट को बच्चों के लिए लक्षित कॉन्टेंट के तौर पर टैग करना है. इससे विज्ञापन के आइडेंटिफ़ायर (आईडीएफ़ए) के ट्रांसमिशन को रोका जाता है.
  • tagForChildDirectedTreatment को false पर सेट करें. इससे यह पता चलेगा कि आपको कोपा के तहत, अपने कॉन्टेंट को बच्चों के लिए लक्षित नहीं करना है.
  • अगर आपको यह नहीं बताना है कि कोपा के तहत, आपको अपने कॉन्टेंट को किस तरह से मैनेज करना है, तो tagForChildDirectedTreatment सेट न करें.

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

Swift

MobileAds.shared.requestConfiguration.tagForChildDirectedTreatment = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForChildDirectedTreatment = @YES;

इस टैग को सेट करके, आप यह पुष्टि करते हैं कि यह सूचना सही है और आपको ऐप्लिकेशन के मालिक की ओर से कार्रवाई करने की अनुमति है. आप समझते हैं कि इस सेटिंग का गलत इस्तेमाल करने से आपका Google खाता बंद हो सकता है.

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

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

इस सेटिंग का इस्तेमाल, Google Mobile Ads SDK के सभी वर्शन के साथ किया जा सकता है. इसके लिए, GADMobileAds.requestConfiguration ऑब्जेक्ट पर tagForUnderAgeOfConsent प्रॉपर्टी सेट करें और true पास करें.

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

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

Swift

MobileAds.shared.requestConfiguration.tagForUnderAgeOfConsent = true

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.tagForUnderAgeOfConsent = @YES;

बच्चों के लिए बने कॉन्टेंट की सेटिंग और tagForUnderAgeOfConsent को चालू करने वाले टैग, दोनों को एक साथ true पर सेट नहीं किया जाना चाहिए. अगर ऐसा होता है, तो बच्चों को ध्यान में रखकर बनाए गए ऐप्लिकेशन की सेटिंग को प्राथमिकता दी जाती है.

विज्ञापन के कॉन्टेंट को फ़िल्टर करना

ऐप्लिकेशन, सभी विज्ञापन अनुरोधों के लिए विज्ञापन के कॉन्टेंट की सबसे ज़्यादा रेटिंग सेट कर सकते हैं. इसके लिए, उन्हें GADRequestConfiguration की maxAdContentRating प्रॉपर्टी का इस्तेमाल करना होगा. यह सेटिंग, सेशन के बाकी समय के लिए विज्ञापन के सभी अनुरोधों पर लागू होती है. इस प्रॉपर्टी की संभावित वैल्यू, डिजिटल कॉन्टेंट लेबल के क्लासिफ़िकेशन पर आधारित होती हैं. साथ ही, इनमें से कोई एक होनी चाहिए:

  • GADMaxAdContentRatingGeneral
  • GADMaxAdContentRatingParentalGuidance
  • GADMaxAdContentRatingTeen
  • GADMaxAdContentRatingMatureAudience

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

Swift

MobileAds.shared.requestConfiguration.maxAdContentRating =
  GADMaxAdContentRating.general

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.maxAdContentRating =
    GADMaxAdContentRatingGeneral;

Publisher Privacy Treatment (Beta)

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

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

Swift

MobileAds.shared.requestConfiguration.publisherPrivacyPersonalizationState =
    .disabled

Objective-C

GADMobileAds.sharedInstance.requestConfiguration.publisherPrivacyPersonalizationState =
    GADPublisherPrivacyPersonalizationStateDisabled;

GAMRequest

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

नेटवर्क की अतिरिक्त जानकारी जोड़ना

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

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

Swift

let request = Request()
let extras = Extras()
extras.additionalParameters = ["collapsible": "bottom"]
request.register(extras)
adLoader?.load(request)

Objective-C

GADRequest *request = [GADRequest request];
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"collapsible": @"bottom"};
[request registerAdNetworkExtras:extras];
[self.adLoader loadRequest:request];

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

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

उदाहरण के लिए, अगर आपका ऐप्लिकेशन https://www.example.com से कॉन्टेंट दिखाते समय विज्ञापन का अनुरोध कर रहा है, तो काम के कीवर्ड को टारगेट करने के लिए यह यूआरएल पास किया जा सकता है:

Swift

let request = AdManagerRequest()
request.contentURL = "https://www.example.com"

Objective-C

GAMRequest *request = [GAMRequest request];
request.contentURL = @"https://www.example.com";

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

Ad Manager के यूज़र इंटरफ़ेस में की-वैल्यू पेयर कॉन्फ़िगर करने के बाद, विज्ञापन दिखाने के अनुरोध में की वैल्यू के साथ कस्टम टारगेटिंग सेट करें. इसके बाद, उन की वैल्यू को टारगेट करने वाले लाइन आइटम, विज्ञापन अनुरोध के लिए विज्ञापन दिखाने की ज़रूरी शर्तें पूरी करते हैं. किसी एक कुंजी के लिए एक से ज़्यादा वैल्यू को टारगेट करने के लिए, वैल्यू को कॉमा लगाकर अलग की गई स्ट्रिंग के तौर पर डालें.

Swift

let request = AdManagerRequest()
request.customTargeting = ["gender" : "male", "section" : "health,fitness"];

Objective-C

GAMRequest *request = [GAMRequest request];
request.customTargeting = @{@"gender" : @"male", @"section" : @"health,fitness"};

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

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

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

Swift

let request = AdManagerRequest()
request.neighboringContentURLs =
    ["https://www.example1.com", "https://www.example2.com",
    "https://www.example3.com", "https://www.example4.com"]

Objective-C

GAMRequest *request = [GAMRequest request];
request.neighboringContentURLs =
    @[@"https://www.example1.com", @"https://www.example2.com",
    @"https://www.example3.com", @"https://www.example4.com"];

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

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

पीपीआईडी को GAMRequest के ज़रिए सेट किया जाता है:

Swift

let request = AdManagerRequest()
request.publisherProvidedID = "AB123456789"

Objective-C

GAMRequest *request = [GAMRequest request];
request.publisherProvidedID = @"AB123456789";

iOS API Demo ऐप्लिकेशन में, पब्लिशर के भेजे गए आइडेंटिफ़ायर (पीपीआईडी) को लागू करने के लिए, Ad Manager के पीपीआईडी का उदाहरण देखें:

Swift Objective-C

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

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

Swift

let extras = Extras()
extras.additionalParameters = [
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    "IAB_AUDIENCE_1_1": [6, 284],
    // Set the content to sedan, station wagon and SUV automotive values.
    "IAB_CONTENT_2_2": [4, 5, 6]
]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{
    // Set the demographic to an audience with an "Age Range" of 30-34 and an
    // interest in mergers and acquisitions.
    @"IAB_AUDIENCE_1_1":@[@6, @284],
    // Set the content to sedan, station wagon and SUV automotive values.
    @"IAB_CONTENT_2_2":@[@4,@5,@6]
};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

अक्सर पूछे जाने वाले सवाल

जब कोई विज्ञापन अपने-आप रीफ़्रेश होता है, तब किस टारगेटिंग का इस्तेमाल किया जाता है?
विज्ञापन रीफ़्रेश होने पर, पहले से तय किया गया GAMRequest ऑब्जेक्ट, टारगेटिंग के लिए फिर से इस्तेमाल किया जाता है. नई टारगेटिंग सेट करने के लिए, GAMRequest ऑब्जेक्ट के साथ GAMBannerView पर loadRequest को साफ़ तौर पर कॉल करें.
मैं मीडिएशन नेटवर्क को अतिरिक्त टारगेटिंग पैरामीटर कैसे पास करूं?
मीडिएशन नेटवर्क को टारगेटिंग की जानकारी भेजने का तरीका जानने के लिए, मीडिएशन देखें.