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

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

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

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

PAL, सेटिंग को मैनेज करने के तरीके को अपडेट कर रहा है, ताकि उपयोगकर्ता की निजता और डेटा के इस्तेमाल पर बेहतर कंट्रोल रखा जा सके. PAL के 1.90.0 वर्शन में forceLimitedAds प्रॉपर्टी जोड़ी गई है. साथ ही, मौजूदा allowStorage प्रॉपर्टी को बंद कर दिया गया है. ये प्रॉपर्टी ConsentSettings क्लास में हैं.

वर्शन 1.90.0 से, PAL डिवाइस के पारदर्शिता और सहमति फ़्रेमवर्क (टीसीएफ़) डेटा को पढ़ता है, ताकि यह पता लगा सके कि उपयोगकर्ता ने लोकल स्टोरेज के इस्तेमाल के लिए सहमति दी है या नहीं. टीसीएफ़ डेटा को पढ़ने के तरीके में हुए इस बदलाव की वजह से, मौजूदा allowStorage प्रॉपर्टी का इस्तेमाल नहीं किया जा सकेगा. आपके ऐप्लिकेशन को अब भी विज्ञापन टैग के यूआरएल में 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 होती है. इससे, विज्ञापनों को सीमित तौर पर दिखाने की सुविधा चालू नहीं होती.

टीसीएफ़ के फ़ेज़ 1 के लिए अपडेट

PAL HTML5 के पहले चरण की रिलीज़ से, आपको ConsentSettings.allowStorage प्रॉपर्टी से, टीसीएफ़ पर आधारित विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा के अपने-आप चालू होने की सुविधा पर स्विच करने में मदद मिलती है.

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

पहले चरण में, PAL इन स्थितियों में विज्ञापनों को सीमित तौर पर दिखाने की सुविधा चालू करता है:

  • allowStorage प्रॉपर्टी की वैल्यू false है या सेट नहीं है. हमारा सुझाव है कि allowStorage प्रॉपर्टी के लिए इस सेटिंग का इस्तेमाल न करें. ऐसा इसलिए, क्योंकि यह सिर्फ़ उन ऐप्लिकेशन के लिए है जिन्हें अपडेट नहीं किया गया है.
  • forceLimitedAds प्रॉपर्टी की वैल्यू true है.
  • PAL को पता चलता है कि IAB (इंटरैक्टिव एडवर्टाइज़िंग ब्यूरो) टीसीएफ़ के मकसद 1 के लिए सहमति नहीं दी गई है.

यहां दी गई टेबल में, सभी संभावित स्थितियां और यह जानकारी दी गई है कि सीमित तौर पर विज्ञापन दिखाने की सुविधा चालू है या नहीं:

टीसीएफ़ के मकसद 1 के लिए सहमति allowStorage प्रॉपर्टी forceLimitedAds प्रॉपर्टी विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा चालू है
स्वीकार की गई सही सही सही
अनुमति नहीं दी गई सही सही सही
स्वीकार की गई सही गलत (डिफ़ॉल्ट) गलत
अनुमति नहीं दी गई सही False (डिफ़ॉल्ट) सही
स्वीकार की गई False (डिफ़ॉल्ट) सही सही
अनुमति नहीं दी गई गलत (डिफ़ॉल्ट) सही सही
स्वीकार की गई गलत (डिफ़ॉल्ट) गलत (डिफ़ॉल्ट) सही
अनुमति नहीं दी गई गलत (डिफ़ॉल्ट) गलत (डिफ़ॉल्ट) सही

टीसीएफ़ के दूसरे फ़ेज़ के लिए तैयारी करना

दूसरे चरण की रिलीज़ में, allowStorage प्रॉपर्टी से कुछ सुविधाएं हटा दी गई हैं. हम दूसरे चरण को पहले चरण के 90 दिनों बाद रिलीज़ करने का प्लान बना रहे हैं. यह 10 मार्च, 2026 को रिलीज़ किया जा सकता है. इस तारीख से पहले, आपको ConsentSettings.forceLimitedAds पैरामीटर का इस्तेमाल करने के लिए, अपने सेटअप को अपडेट करना होगा.

दूसरे फ़ेज़ की रिलीज़ के लिए, PAL सिर्फ़ इन आधारों पर विज्ञापनों को सीमित तौर पर दिखाने की सुविधा चालू करता है: टीसीएफ़ के मकसद 1 के लिए सहमति न मिलना और ConsentSettings.forceLimitedAds प्रॉपर्टी का इस्तेमाल करना ज़रूरी नहीं है:

टीसीएफ़ के मकसद 1 के लिए सहमति forceLimitedAds प्रॉपर्टी विज्ञापनों को सीमित तौर पर दिखाए जाने की सुविधा चालू है
स्वीकार की गई सही सही
अनुमति नहीं दी गई सही सही
स्वीकार की गई गलत (डिफ़ॉल्ट) गलत
अनुमति नहीं दी गई गलत (डिफ़ॉल्ट) सही

Google Ad Manager की ग्लोबल सेटिंग से मेल खाना चाहिए

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

ये एपीआई उपलब्ध हैं:

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

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

const consentSettings = new goog.pal.ConsentSettings();
consentSettings.allowStorage = true;
// During the PAL Phase 1 release, best practice is to always set the
// `allowStorage` property to a `true` value 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.

const adManagerSettings = new goog.pal.GoogleAdManagerSettings();
// Add this line if the "Programmatic limited ads" toggle is turned off in
// Ad Manager.
adManagerSettings.disableLimitedAdsStorage = true;
// Add this line if the "First party cookies for ads on web" toggle
// is turned off in Ad Manager.
adManagerSettings.disableFirstPartyIdentifiers = true;

const nonceLoader = new goog.pal.NonceLoader(consentSettings, adManagerSettings);