सीमित तौर पर दिखाए जाने वाले विज्ञापन और पहले पक्ष के आइडेंटिफ़ायर की सेटिंग

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

इस गाइड में, आपके ऐप्लिकेशन में विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा की सेटिंग इस्तेमाल करने के बारे में बताया गया है. साथ ही, इसमें ऐप्लिकेशन के व्यवहार को Google Ad Manager नेटवर्क की ग्लोबल सेटिंग से मैच करने के बारे में भी बताया गया है.

क्लाइंट के लिए, विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा की सेटिंग कॉन्फ़िगर करना

PAL के 23.0.0 वर्शन में forceLimitedAds प्रॉपर्टी जोड़ी गई है और allowStorage प्रॉपर्टी को हटा दिया गया है. यह प्रॉपर्टी, ConsentSettings क्लास में है.

वर्शन 23.0.0 से, PAL, डिवाइस के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) डेटा को पढ़ेगा, ताकि यह पता लगा सके कि उपयोगकर्ता ने लोकल स्टोरेज के इस्तेमाल के लिए सहमति दी है या नहीं. इससे पहले, आपके ऐप्लिकेशन की यह ज़िम्मेदारी थी कि वह स्टोरेज के लिए सहमति ले. आपके ऐप्लिकेशन को अब भी विज्ञापन टैग के यूआरएल में gdpr= और gdpr_consent= पैरामीटर पास करने होंगे.

अगर टीसीएफ़ के आधार पर अपने-आप तय होने वाली सेटिंग से काम नहीं चलता है, तो अपने ऐप्लिकेशन में सीधे तौर पर forceLimitedAds प्रॉपर्टी सेट करें. ज़्यादा जानकारी के लिए, IAB Europe टीसीएफ़ के साथ पब्लिशर इंटिग्रेशन लेख पढ़ें. forceLimitedAds प्रॉपर्टी को true वैल्यू पर सेट करने से, PAL को सर्वर को भेजे गए नॉनस में उपयोगकर्ता आइडेंटिफ़ायर सेव करने या भेजने से रोका जा सकता है. forceLimitedAds प्रॉपर्टी को true वैल्यू पर सेट करना, IMA (इंटरैक्टिव मीडिया विज्ञापन) एसडीके में विज्ञापन दिखाने के अनुरोध वाले यूआरएल में ltd=1 पैरामीटर जोड़ने जैसा ही है. विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा के बारे में ज़्यादा जानने के लिए, ltd (विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा) लेख पढ़ें. forceLimitedAds प्रॉपर्टी को true वैल्यू पर सेट करने पर, PAL, नॉनस में ltd=1 पैरामीटर को शामिल करता है.

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

टीसीएफ़ के आधार पर तय करने के लिए, PAL को लागू करने का तरीका अपडेट करना

PAL Android को 23.0.0 वर्शन पर अपडेट करने के लिए, कार्रवाई करनी होगी. इससे PAL, डिवाइस के टीसीएफ़ डेटा को पढ़ पाएगा, ताकि यह पता लगाया जा सके कि उपयोगकर्ता ने लोकल स्टोरेज के इस्तेमाल के लिए सहमति दी है या नहीं. इस वर्शन में, forceLimitedAds प्रॉपर्टी को भी जोड़ा गया है और allowStorage प्रॉपर्टी को हटाया गया है. अपने ऐप्लिकेशन को सिर्फ़ तब forceLimitedAds प्रॉपर्टी का इस्तेमाल करने के लिए अपडेट करें, जब टीसीएफ़ के आधार पर सीमित तौर पर विज्ञापन दिखाने की सुविधा चालू करने से, आपके ऐप्लिकेशन की ज़रूरतें पूरी न होती हों. टीसीएफ़ के आधार पर सहमति का पता लगाने के बारे में ज़्यादा जानने के लिए, IAB Europe टीसीएफ़ के साथ पब्लिशर के ऐप्लिकेशन को इंटिग्रेट करना लेख पढ़ें.

Google Ad Manager की ग्लोबल सेटिंग से मैच करना

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

एपीआई के नाम यहां दिए गए हैं:

  • disableLimitedAdsStorage - इससे अमान्य ट्रैफ़िक का पता लगाने वाले आइडेंटिफ़ायर बंद हो जाते हैं और विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा के लिए, लोकल स्टोरेज का इस्तेमाल नहीं किया जा सकता. अगर आपने Ad Manager में एडमिन > ग्लोबल सेटिंग में जाकर, प्रोग्राम के हिसाब से विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा सेटिंग को अपडेट किया है, तो इस एपीआई का इस्तेमाल करके, पीएएल में विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा के लिए, लोकल स्टोरेज के इस्तेमाल को बंद करें. ध्यान दें कि यह सेटिंग, सीमित तौर पर दिखाए जाने वाले विज्ञापनों के अलावा अन्य विज्ञापनों पर लागू नहीं होती.
  • disableFirstPartyIdentifiers - विज्ञापन चुनने के लिए इस्तेमाल किए जाने वाले पहले पक्ष के आइडेंटिफ़ायर बंद करता है. अगर आपने Ad Manager में ऐप्लिकेशन पर दिखने वाले विज्ञापनों के लिए, पहले पक्ष के आइडेंटिफ़ायर सेटिंग को एडमिन > ग्लोबल सेटिंग में जाकर अपडेट किया है, तो इस API का इस्तेमाल करके PAL में ऐसे आइडेंटिफ़ायर बंद करें. ध्यान दें कि यह सेटिंग, अमान्य ट्रैफ़िक का पता लगाने के लिए आइडेंटिफ़ायर और लोकल स्टोरेज के इस्तेमाल पर लागू नहीं होती.

यहां दिए गए उदाहरण में, PAL को लागू करने के दौरान उपयोगकर्ता की निजता और डेटा के इस्तेमाल को मैनेज करने का तरीका बताया गया है:

ConsentSettings consentSettings = ConsentSettings.builder()
            .directedForChildOrUnknownAge(false)
            .build();
// PAL Android version 23.0.0 introduces
// `ConsentSettings.forceLimitedAds` and removes `ConsentSettings.allowStorage`.
// Best practice is to not set `forceLimitedAds` to allow PAL to automatically
// determine whether limited ads applies based on the TCF data.
// To enable limited ads regardless of the TCF determination, set the
// `forceLimitedAds` property to a `true` value.

GoogleAdManagerSettings adManagerSettings = GoogleAdManagerSettings.builder()
            // Add this line if the "Programmatic limited ads" toggle is turned
            // off in Ad Manager.
            .disableLimitedAdsStorage(true)
            // Add this line if the
            // "First party identifiers for ads on app" toggle is turned
            // off in Ad Manager.
            .disableFirstPartyIdentifiers(true)
            .build();

nonceLoader = new NonceLoader(this, consentSettings, adManagerSettings);