लक्ष्यीकरण


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

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

RequestConfiguration

RequestConfiguration एक स्ट्रक्चर है, जो टारगेटिंग की जानकारी इकट्ठा करता है. इस जानकारी को SetRequestConfiguration() ग्लोबल फ़ंक्शन के ज़रिए, ग्लोबल तौर पर लागू किया जाता है.

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

  firebase::gma::RequestConfiguration retrieved_configuration =
    firebase::gma::GetRequestConfiguration();

  // .. apply your changes, then:

  firebase::gma::SetRequestConfiguration(request_configuration);

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

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

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

इस सेटिंग को कॉन्फ़िगर करने के लिए, RequestConfiguration स्ट्रक्चर के tag_for_child_directed_treatment मेंबर को इनमें से किसी एक एनुमरेशन वैल्यू पर असाइन करें:

  • RequestConfiguration::tag_for_child_directed_treatment को RequestConfiguration::kChildDirectedTreatmentTrue पर सेट करें. इससे यह पता चलेगा कि आपको कोपा के तहत, अपने कॉन्टेंट को 'बच्चों के लिए' के तौर पर दिखाना है.
  • RequestConfiguration::kChildDirectedTreatmentFalse को RequestConfiguration::tag_for_child_directed_treatment असाइन करें. इससे यह पता चलेगा कि आपको कोपा के तहत, अपने कॉन्टेंट को बच्चों के लिए बने कॉन्टेंट के तौर पर नहीं दिखाना है.
  • अगर आपको विज्ञापन दिखाने के अनुरोधों में यह नहीं बताना है कि कोपा के तहत आपके कॉन्टेंट को किस तरह से ट्रीट किया जाए, तो RequestConfiguration::kChildDirectedTreatmentUnspecified को RequestConfiguration::tag_for_child_directed_treatment असाइन करें.

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_child_directed_treatment =
    firebase::RequestConfiguration::kChildDirectedTreatmentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

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

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

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

बच्चों को ध्यान में रखकर बनाई गई सेटिंग की तरह ही, RequestConfiguration में एक मेंबर होता है. इसकी मदद से, टीएफ़यूए पैरामीटर को कॉन्फ़िगर किया जा सकता है: tag_for_under_age_of_consent. इसे यहां दी गई एनुमरेशन वैल्यू के साथ कॉन्फ़िगर किया जा सकता है:

  • RequestConfiguration::tag_for_under_age_of_consent को RequestConfiguration::kUnderAgeOfConsentTrue पर सेट करें. इससे यह पता चलेगा कि आपको यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले, सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए विज्ञापन दिखाने के अनुरोध को सीमित डेटा प्रोसेसिंग के लिए मार्क करना है.
  • RequestConfiguration::tag_for_under_age_of_consent को RequestConfiguration::kUnderAgeOfConsentFalse पर सेट करें. इससे यह पता चलेगा कि आपको यूरोपियन इकनॉमिक एरिया (ईईए) में रहने वाले, सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए, विज्ञापन दिखाने के अनुरोध को सीमित डेटा प्रोसेसिंग मोड में नहीं रखना है.
  • RequestConfiguration::tag_for_under_age_of_consent को RequestConfiguration::kUnderAgeOfConsentUnspecified पर सेट करें. इससे यह पता चलता है कि आपने यह तय नहीं किया है कि विज्ञापन दिखाने के अनुरोध को यूरोपियन इकनॉमिक एरिया (ईईए) में सहमति देने की मान्य उम्र से छोटे उपयोगकर्ताओं के लिए बने विज्ञापन दिखाने के अनुरोध के तौर पर माना जाए या नहीं.

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

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.tag_for_under_age_of_consent =
    firebase::RequestConfiguration::kUnderAgeOfConsentTrue;

  firebase::gma::SetRequestConfiguration(request_configuration);

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

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

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

  • RequestConfiguration::kMaxAdContentRatingG
  • RequestConfiguration::kMaxAdContentRatingPG
  • RequestConfiguration::kMaxAdContentRatingT
  • RequestConfiguration::kMaxAdContentRatingMA

यहां दिया गया कोड, RequestConfiguration स्ट्रक्चर को कॉन्फ़िगर करता है. इससे यह तय होता है कि विज्ञापन का जो कॉन्टेंट दिखाया जाए वह डिजिटल कॉन्टेंट लेबल के हिसाब से, G से ज़्यादा रेटिंग वाला न हो:

  firebase::gma::RequestConfiguration request_configuration =
    firebase::gma::GetRequestConfiguration();

  request_configuration.max_ad_content_rating =
    firebase::RequestConfiguration::kMaxAdContentRatingG;

  firebase::gma::SetRequestConfiguration(request_configuration);

AdRequest

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

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

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

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

  // AdRequest with content URL:
  firebase::admob::AdRequest ad_request(/*content_url=*/"https://www.example.com");

  // AdRequest without content URL:
  firebase::admob::AdRequest ad_request();