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

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

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