इस पेज का अनुवाद Cloud Translation API से किया गया है.

निजता और मैसेजिंग JavaScript एपीआई

परिचय

यह एपीआई, निजता और मैसेज सेवा टैब में उपलब्ध मैसेज के साथ इंटरैक्ट करने के लिए टूल उपलब्ध कराता है. इसकी मदद से, ये काम किए जा सकते हैं:

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

इत्यादि.

इन टूल का इस्तेमाल करके, इंडस्ट्री स्टैंडर्ड प्रोटोकॉल का इस्तेमाल करके उपयोगकर्ता की सहमति भी ली जा सकती है:

IAB टीसीएफ़ के 2.0 वर्शन के स्पेसिफ़िकेशन का इस्तेमाल करके जीडीपीआर के तहत सहमति लेना
IAB GPP की शर्तों का इस्तेमाल करके, अमेरिका के राज्यों में लागू निजता कानूनों के तहत ऑप्ट-आउट करना

इन मामलों में, सहमति की स्थिति की जानकारी इन एपीआई के ज़रिए दी जाती है.

उपयोगकर्ताओं को मैसेज दिखाने की इस सुविधा को अपनी साइट पर इन तरीकों से लागू किया जा सकता है:

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

googlefc वह ग्लोबल नेमस्पेस है जिसका इस्तेमाल, उपयोगकर्ता को मैसेज दिखाने की सुविधा करती है. यह सुविधा, JavaScript Window पर मौजूद अपने एपीआई के लिए इस नेमस्पेस का इस्तेमाल करती है.

ध्यान दें: इस रेफ़रंस में google-closure टाइप के एनोटेशन का इस्तेमाल किया गया है. यहां उदाहरणों के साथ, कम शब्दों में जानकारी दी गई है:

boolean: JavaScript का बूलियन टाइप.
number|string: यूनियन टाइप. वैल्यू, संख्या या स्ट्रिंग में से कोई एक होनी चाहिए.
?string: इससे पता चलता है कि वैल्यू, स्ट्रिंग टाइप की है या शून्य है. स्ट्रिंग, संख्या, और बूलियन टाइप की वैल्यू डिफ़ॉल्ट रूप से शून्य नहीं होती हैं.
Array<string>: स्ट्रिंग का कलेक्शन.
googlefc.CallbackQueue: googlefc.CallbackQueue क्लास का ऑब्जेक्ट.
!googlefc.CallbackQueue: इससे पता चलता है कि वैल्यू, googlefc.CallbackQueue टाइप की है और शून्य नहीं है. डिफ़ॉल्ट रूप से, सभी ऑब्जेक्ट टाइप में शून्य वैल्यू हो सकती है.
!Array<!googlefc.CallbackQueue>: googlefc.CallbackQueue ऑब्जेक्ट का कलेक्शन. हर ऑब्जेक्ट शून्य नहीं है. ऐरे अमान्य नहीं है.
!googlefc.ConsentStatusEnum: ConsentStatusEnum में मौजूद नंबर.
!googlefc.AdBlockerStatusEnum: AdBlockerStatusEnum में मौजूद नंबर.
!googlefc.AllowAdsStatusEnum: AllowAdsStatusEnum में मौजूद नंबर.
!googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum: यह संख्या, InitialUsStatesOptOutStatusEnum में शामिल है.
!googlefc.ConsentModePurposeStatusEnum: यह संख्या, ConsentModePurposeStatusEnum में शामिल होती है.
!googlefc.ccpa.InitialCcpaStatusEnum: InitialCcpaStatusEnum में मौजूद नंबर.

ज़्यादा जानकारी के लिए, Google Closure के दस्तावेज़ पढ़ें.

फ़ील्ड की खास जानकारी

नाम	टाइप	परिभाषा
`googlefc.controlledMessagingFunction`	function(!Object)	यह फ़ंक्शन यह तय करता है कि मैसेजिंग जारी रखनी है या नहीं. यह सुविधा, सभी तरह के मैसेज के लिए उपलब्ध है.
`googlefc.callbackQueue`	!Array<!Object<string, function()>> \| !Array<function()> \| !googlefc.CallbackQueue	उपयोगकर्ता को मैसेज दिखाने से जुड़ी क्वेरी को एसिंक्रोनस तरीके से लागू करने के लिए, कॉलबैक क्यू का रेफ़रंस.
`googlefc.CallbackQueue`	!ऑब्जेक्ट	कॉल बैक करने के लिए, क्यू ऑब्जेक्ट का टाइप.
`googlefc.AdBlockerStatusEnum`	!Object<string, number>	यह एक इनम है, जो विज्ञापन रोकने वाले सॉफ़्टवेयर की स्थिति को दिखाता है.
`googlefc.AllowAdsStatusEnum`	!Object<string, number>	उपयोगकर्ता को विज्ञापन दिखाने की अनुमति है या नहीं, यह बताने वाला enum.
`googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum`	!Object<string, number>	यह एक इनम है. इससे अमेरिका के राज्यों में रहने वाले उपयोगकर्ता के ऑप्ट-आउट करने की शुरुआती स्थिति के बारे में पता चलता है. इसमें यह जानकारी शामिल होती है कि उपयोगकर्ता अमेरिका के किस राज्य में मौजूद है.
`googlefc.GoogleFcConsentModeUserStatus`	!ऑब्जेक्ट	`googlefc.getGoogleConsentModeValues` के लिए रिटर्न टाइप.
`googlefc.ConsentModePurposeStatusEnum`	!Object<string, number>	यह एक इनम है. इससे सहमति मोड के मकसद के लिए, असली उपयोगकर्ता के फ़ैसले के बारे में पता चलता है.
`googlefc.usstatesoptout.overrideDnsLink`	undefined\|boolean	यह एक बूलियन है. इसे 'सही' पर सेट करके, 'मेरी निजी जानकारी न बेचें या शेयर न करें' लिंक का इस्तेमाल किया जा सकता है.
`googlefc.ccpa.InitialCcpaStatusEnum` *लेगसी. इसे प्राथमिकता दी जाती है `googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum`.*	!Object<string, number>	अमेरिका के राज्यों के कानूनों के हिसाब से उपयोगकर्ता की शुरुआती स्थिति को दिखाने वाला एक enum.
`googlefc.ccpa.overrideDnsLink` *लेगसी. इसे प्राथमिकता दी जाती है `googlefc.usstatesoptout.overrideDnsLink`.*	undefined\|boolean	यह एक बूलियन है. इसे 'सही' पर सेट करके, 'मेरी निजी जानकारी न बेचें या शेयर न करें' लिंक का इस्तेमाल किया जा सकता है.

तरीकों के बारे में खास जानकारी

नाम	रिटर्न टाइप	परिभाषा
`googlefc.showRevocationMessage()`	तय नहीं है	यह कुकी, सहमति के रिकॉर्ड को मिटाती है और `googlefc` स्क्रिप्ट को फिर से लोड करती है, ताकि उपयोगकर्ता को सहमति जताने वाला मैसेज दिखाया जा सके.
`googlefc.getAdBlockerStatus()`	संख्या	यह फ़ंक्शन, उपयोगकर्ता के विज्ञापन ब्लॉक करने की स्थिति के आधार पर `AdBlockerStatusEnum` में वैल्यू दिखाता है.
`googlefc.getAllowAdsStatus()`	संख्या	यह कुकी, उपयोगकर्ता के लिए विज्ञापन दिखाने की अनुमति की स्थिति के आधार पर `AllowAdsStatusEnum` में वैल्यू दिखाती है.
`googlefc.usstatesoptout.getInitialUsStatesOptOutStatus()`	संख्या	यह फ़ंक्शन, उपयोगकर्ता के लिए अमेरिका के कानूनों के हिसाब से तैयार किए गए मैसेज से ऑप्ट-आउट करने की शुरुआती स्थिति के आधार पर, `InitialUsStatesOptOutStatusEnum` में वैल्यू दिखाता है. इसमें उपयोगकर्ता की मौजूदा जगह के हिसाब से लागू होने वाले कानून का ध्यान रखा जाता है.
`googlefc.usstatesoptout.openConfirmationDialog(function(boolean))`	तय नहीं है	अगर 'मेरी निजी जानकारी न बेचें या शेयर न करें' लिंक को डिफ़ॉल्ट तौर पर सेट नहीं किया गया है, तो यह कुकी, अमेरिका के राज्य के नियमों के मुताबिक ऑप्ट-आउट करने की पुष्टि करने वाला डायलॉग बॉक्स खोलती है.
`googlefc.getGoogleConsentModeValues()`	!ऑब्जेक्ट	यह फ़ंक्शन, `googlefc.GoogleFcConsentModeUserStatus` ऑब्जेक्ट दिखाता है. इसमें उपयोगकर्ता के लिए, सहमति मोड की मौजूदा वैल्यू होती हैं. साथ ही, सहमति मोड के हर उपलब्ध मकसद के लिए एक वैल्यू होती है.
`googlefc.ccpa.getInitialCcpaStatus()` *लेगसी. `googlefc.usstatesoptout.getInitialUsStatesOptOutStatus()` को प्राथमिकता दी जाती है.*	संख्या	यह फ़ंक्शन, उपयोगकर्ता के लिए अमेरिका के कानूनों के हिसाब से तैयार किए गए मैसेज से ऑप्ट-आउट करने की शुरुआती स्थिति के आधार पर, `InitialCcpaStatusEnum` में वैल्यू दिखाता है.
`googlefc.ccpa.openConfirmationDialog(function(boolean))` *लेगसी. `googlefc.usstatesoptout.openConfirmationDialog()` को प्राथमिकता दी जाती है.*	तय नहीं है	अगर 'मेरी निजी जानकारी न बेचें या शेयर न करें' लिंक को डिफ़ॉल्ट रूप से सेट नहीं किया गया है, तो यह कुकी, अमेरिका के राज्य के कानूनों के मुताबिक ऑप्ट-आउट करने की पुष्टि करने वाला डायलॉग बॉक्स खोलती है.

अपनी साइट पर टेस्टिंग और डीबग करना

'निजता और मैसेज सेवा' में डीबग करने और टेस्टिंग की सुविधा मिलती है. इससे यह देखा जा सकता है कि आपकी साइट पर, मैसेज, मैसेज के उप-टाइप या मैसेज के कॉम्बिनेशन कैसे दिखते हैं.

ज़रूरी शर्तें:

आपको जिन मैसेज की झलक देखनी है उन्हें उस साइट पर पब्लिश किया जाना चाहिए जिस पर आपको जांच करनी है

नीचे दिए गए डीबग करने वाले यूआरएल पैरामीटर का इस्तेमाल करके, अपनी साइट पर लाइव झलक देखी जा सकती है:

डीबग पैरामीटर इस्तेमाल की जा सकने वाली वैल्यू

fc alwaysshow (डीबग/झलक मोड को ट्रिगर करने के लिए)

fctype ab (विज्ञापन रोकने वाले मैसेज), ccpa (अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने के मैसेज), gdpr (जीडीपीआर के तहत सहमति लेने के मैसेज), monetization (Offerwall मैसेज), usfl (अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने के मैसेज, सिर्फ़ फ़्लोरिडा के लिए), usnat (अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने के मैसेज, फ़्लोरिडा को छोड़कर सभी राज्यों के लिए; ccpa के बराबर)

डीबग पैरामीटर	इस्तेमाल की जा सकने वाली वैल्यू
`fc`	`alwaysshow` (डीबग/झलक मोड को ट्रिगर करने के लिए)
`fctype`	`ab` (विज्ञापन रोकने वाले मैसेज), `ccpa` (अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने के मैसेज), `gdpr` (जीडीपीआर के तहत सहमति लेने के मैसेज), `monetization` (Offerwall मैसेज), `usfl` (अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने के मैसेज, सिर्फ़ फ़्लोरिडा के लिए), `usnat` (अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने के मैसेज, फ़्लोरिडा को छोड़कर सभी राज्यों के लिए; `ccpa` के बराबर)

अपनी साइट (foo.com) पर इसकी झलक देखने के लिए, इसे इस्तेमाल करने के कुछ उदाहरण:

अमेरिका के कानूनों के तहत, ऑप्ट-आउट करने के बारे में बताने वाले मैसेज की जांच करना -- http://foo.com/?fc=alwaysshow&fctype=ccpa
जीडीपीआर मैसेजिंग की जांच करना -- http://foo.com/?fc=alwaysshow&fctype=gdpr

फ़ील्ड: जानकारी और उदाहरण

googlefc.controlledMessagingFunction {function(!Object)}

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

अगर अन्य स्क्रिप्ट लोड होने से पहले, Window पर googlefc.controlledMessagingFunction को तय किया जाता है, तो message.proceed(boolean) को कॉल करने तक मैसेज नहीं दिखते. कॉलिंग message.proceed(true) की सुविधा चालू होने पर, मैसेजिंग की सुविधा सामान्य तरीके से काम करती है. वहीं, कॉलिंग message.proceed(false) की सुविधा चालू होने पर, पेजव्यू के लिए कोई भी मैसेज नहीं दिखता.

चेतावनी: अगर पेज पर googlefc.controlledMessagingFunction को तय किया गया है, तो message.proceed() को कॉल किए जाने तक, निजता और मैसेज सेवा वाले कोई भी मैसेज नहीं दिखेंगे. इससे विज्ञापन दिखाने में देरी हो सकती है. इसलिए, आपको यह पक्का करना चाहिए कि message.proceed() को पेज लोड होने के तुरंत बाद कॉल किया जाए, ताकि यह पक्का किया जा सके कि मैसेजिंग और विज्ञापन दिखाने का तरीका आपकी उम्मीद के मुताबिक हो.

उदाहरण: मान लें कि आपके पेज पर यह स्क्रिप्ट है. यह एक एसिंक फ़ंक्शन determineIfUserIsSubscriber() को तय करती है. यह फ़ंक्शन यह जांच करता है कि लॉग इन किया हुआ उपयोगकर्ता सदस्य है या नहीं.

<head>
  <script>
    window.isSubscriber = undefined;
    function determineIfUserIsSubscriber() {
      if (isSubscriber !== undefined) {
        return isSubscriber;
      }
      return new Promise(resolve => {
        setTimeout(() => {
          // Change this to true if you want to test what subscribers would see.
          window.isSubscriber = false;
          resolve(window.isSubscriber);
        }, 1000);
      });
    }
  </script>
</head>

इस उदाहरण में बताया गया है कि सिर्फ़ उन लोगों को मैसेज दिखाने के लिए googlefc.controlledMessagingFunction का इस्तेमाल कैसे किया जा सकता है जिन्होंने चैनल की सदस्यता नहीं ली है.

<head>
  <script>
    // Define googlefc and the controlled messaging function on the Window.
    window.googlefc = window.googlefc || {};
    googlefc.controlledMessagingFunction = async (message) => {
      // Determine if the user is a subscriber asynchronously.
      const isSubscriber = await determineIfUserIsSubscriber();

      if (isSubscriber) {
        // If the user is a subscriber, don't show any messages.
        message.proceed(false);
      } else {
        // Otherwise, show messages as usual.
        message.proceed(true);
      }
    }
  </script>
</head>

इस सुविधा का एक एक्सटेंशन भी है. इससे पब्लिशर यह तय कर सकते हैं कि सिर्फ़ Offerwall को छिपाया जाए. इस सुविधा एक्सटेंशन का इस्तेमाल करके, अन्य मैसेज टाइप को बंद किए बिना ऑफ़रवॉल को बंद करें.

Offerwall के लिए कंट्रोल किए गए मैसेज दिखाने की सुविधा, message.proceed() में एक और पैरामीटर पास करके चालू की जाती है. message.proceed(), googlefc.MessageTypeEnum टाइप का होता है.Array

उदाहरण: यहां googlefc.controlledMessagingFunction का इस्तेमाल करके, सिर्फ़ सदस्यों के लिए Offerwall दिखाने की सुविधा को बंद करने का उदाहरण दिया गया है. इसमें अन्य मैसेज टाइप दिखाने की सुविधा बंद नहीं की गई है:

<head>
  <script>
    // Define googlefc and the controlled messaging function on the Window.
    window.googlefc = window.googlefc || {};
    googlefc.controlledMessagingFunction = async (message) => {
     // Determine if the Offerwall should display or not.
     const shouldDisplayOfferwall = await determineIfUserIsSubscriber();
     const applicableMessageTypes = [];

     if (!shouldDisplayOfferwall) {
       // Do not show the Offerwall, but allow other message types to display.
       applicableMessageTypes.push(window.googlefc.MessageTypeEnum.OFFERWALL);
       message.proceed(false, applicableMessageTypes);
     } else {
       // Otherwise, show messages as usual.
       message.proceed(true);
     }
    }
  </script>
</head>

अहम जानकारी: message.proceed(true) को सिर्फ़ कॉल करने से, Offerwall मैसेज दिखता है. इससे यह गारंटी नहीं मिलती कि Offerwall मैसेज दिखेगा ही. Offerwall में कई तरह के बदलाव किए जा सकते हैं. इनसे मैसेज रेंडर होने के समय पर असर पड़ सकता है. इसलिए, controlledMessagingFunction का इस्तेमाल करते समय इस बात का ध्यान रखना चाहिए. उदाहरण के लिए, मैसेज की फ़्रीक्वेंसी सेटिंग को दो पेज व्यू के बाद दिखने से बदलकर, शून्य पेज व्यू के बाद दिखने पर सेट करें. इससे, इस सुविधा की वजह से Offerwall के दिखने पर कोई असर नहीं पड़ेगा.

googlefc.callbackQueue {!Array<!Object<string, function()>> | !Array<function()> | !googlefc.CallbackQueue}

यह मैसेजिंग से जुड़े कॉल को एसिंक्रोनस तरीके से एक्ज़ीक्यूट करने के लिए, ग्लोबल कॉलबैक कतार का रेफ़रंस देता है. किसी फ़ंक्शन को लागू करने का सिर्फ़ एक तरीका है. इसके लिए, आपको उसे callbackQueue में जोड़ना होगा.

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

इस्तेमाल की जा सकने वाली कुंजियां:

कुंजी का नाम	इस्तेमाल	रिलेटिव लेटेंसी
`CONSENT_API_READY`	`CONSENT_API_READY` कुंजी के साथ कॉलबैक क्यू में पुश किए गए फ़ंक्शन तब लागू होते हैं, जब सहमति वाले फ़्रेमवर्क के लिए एपीआई तय किए जाते हैं और उन्हें कॉल किया जा सकता है. इसके बाद, जोड़े गए किसी भी `CONSENT_API_READY`-की वाले फ़ंक्शन को सिंक्रोनस तरीके से लागू किया जाता है. फ़्रेमवर्क के बारे में खास जानकारी पाने के लिए, आईएबी फ़्रेमवर्क के बारे में सेक्शन देखें.	कम
`CONSENT_DATA_READY`	`CONSENT_DATA_READY` कुंजी के साथ कॉलबैक क्यू में पुश किए गए फ़ंक्शन तब लागू होते हैं, जब सहमति के लिए इस्तेमाल किए जा सकने वाले फ़्रेमवर्क के तहत उपयोगकर्ता की सहमति मिल जाती है. ऐसा पहले के किसी अनुरोध के दौरान या उपयोगकर्ता के सहमति वाले मैसेज के साथ इंटरैक्ट करने के बाद होता है. इसके बाद, जोड़े गए किसी भी `CONSENT_DATA_READY`-की वाले फ़ंक्शन को सिंक्रोनस तरीके से लागू किया जाता है.	ज़्यादा
`AD_BLOCK_DATA_READY`	`AD_BLOCK_DATA_READY` कुंजी के साथ कॉलबैक क्यू में पुश किए गए फ़ंक्शन, विज्ञापन ब्लॉक करने से जुड़ा डेटा फ़्लो में उपलब्ध होने पर लागू होते हैं. इसके बाद, जोड़े गए किसी भी `AD_BLOCK_DATA_READY`-की वाले फ़ंक्शन को सिंक्रोनस तरीके से लागू किया जाता है.	ज़्यादा
`CONSENT_MODE_DATA_READY`	`CONSENT_MODE_DATA_READY` कुंजी के साथ कॉलबैक क्यू में पुश किए गए फ़ंक्शन तब लागू होते हैं, जब Google [सहमति मोड](https://support.google.com/google-ads/answer/10000067) का डेटा (Google Ads और Analytics टैग के साथ इस्तेमाल करने के लिए) फ़्लो में उपलब्ध हो जाता है. सहमति मोड का डेटा तैयार होने के बाद, `googlefc.getGoogleConsentModeValues` का इस्तेमाल करके, सहमति मोड की वैल्यू को कभी भी ऐक्सेस किया जा सकता है.	मीडियम
`INITIAL_US_STATES_OPT_OUT_DATA_READY`	`INITIAL_US_STATES_OPT_OUT_DATA_READY` कुंजी के साथ कॉलबैक क्यू में पुश किए गए फ़ंक्शन तब लागू होते हैं, जब अमेरिका के राज्य के कानूनों से जुड़ा डेटा फ़्लो में उपलब्ध हो जाता है. ध्यान दें कि अमेरिका के राज्य के कानूनों से जुड़े डेटा के लिए, बाद में किए गए किसी भी अनुरोध को सीधे तौर पर GPP API (`__gpp`) को कॉल करके हासिल किया जाना चाहिए.	मीडियम
`INITIAL_CCPA_DATA_READY`	अमेरिका के कानूनों के लिए लेगसी कुंजी. `INITIAL_US_STATES_OPT_OUT_DATA_READY` को प्राथमिकता दी जाती है. `INITIAL_CCPA_DATA_READY` कुंजी के साथ कॉलबैक क्यू में पुश किए गए फ़ंक्शन तब लागू होते हैं, जब अमेरिका के कानूनों के बारे में बताने वाले मैसेज का डेटा फ़्लो में उपलब्ध हो जाता है. ध्यान दें कि अमेरिका के राज्य के कानूनों से जुड़े डेटा के लिए, बाद में किए गए किसी भी अनुरोध को सीधे तौर पर GPP API (`__gpp`) को कॉल करके हासिल किया जाना चाहिए.	मीडियम

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

googlefc.CallbackQueue {!Object}

तरीके के बारे में खास जानकारी:

नाम	टाइप	पैरामीटर	रिटर्न टाइप	भूमिका
`push(data)`	संख्या	`data`: यह एक की-वैल्यू पेयर है. इसमें कुंजी, डेटा की उपलब्धता के टाइप में से एक होती है. साथ ही, वैल्यू, JavaScript फ़ंक्शन होती है जिसे लागू किया जाना है. डेटा की उपलब्धता के लिए इन कुंजियों का इस्तेमाल किया जा सकता है: `CONSENT_API_READY`, `CONSENT_DATA_READY`, `AD_BLOCK_DATA_READY`, `INITIAL_US_STATES_OPT_OUT_DATA_READY`, `CONSENT_MODE_DATA_READY` और (लेगसी) `INITIAL_CCPA_DATA_READY`.	अब तक जोड़ी गई कमांड की संख्या. इससे, ऐरे की मौजूदा लंबाई मिलती है.	यह फ़ंक्शन, पास किए गए फ़ंक्शन को उस क्रम में लागू करता है जिस क्रम में डेटा उपलब्ध होता है. इसके बाद, यह उन फ़ंक्शन को उस क्रम में लागू करता है जिस क्रम में उन्हें कतार में जोड़ा जाता है.

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.usstatesoptout = window.googlefc.usstatesoptout || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY':
    () => {
      if (googlefc.getAdBlockerStatus() == googlefc.AdBlockerStatusEnum.NO_AD_BLOCKER) {
        // Handle a non-ad blocking user.
      }
    }
  });
</script>

googlefc.AdBlockerStatusEnum {!Object<string, number>}

यह कुकी, विज्ञापन रोकने की सुविधा के लिए उपयोगकर्ता की अलग-अलग स्थितियों के बारे में बताती है. अलग-अलग स्थितियां ये हैं:

googlefc.AdBlockerStatusEnum = {
  // Something failed, in an unknown state.
  UNKNOWN: 0,
  // The user was running an extension level ad blocker.
  EXTENSION_AD_BLOCKER: 1,
  // The user was running a network level ad blocker.
  NETWORK_LEVEL_AD_BLOCKER: 2,
  // The user was not blocking ads.
  NO_AD_BLOCKER: 3,
};

googlefc.AllowAdsStatusEnum {!Object<string, number>}

यह कुकी, विज्ञापन रोकने वाले उपयोगकर्ता के लिए, विज्ञापनों को अनुमति देने की अलग-अलग स्थितियां दिखाती है. अलग-अलग स्टेट ये हैं:

googlefc.AllowAdsStatusEnum = {
  // Something failed, in an unknown state.
  UNKNOWN: 0,
  // User is currently using an ad blocker, was never using an ad blocker, or
  // allowed ads, but not because they saw the Privacy & messaging message.
  ADS_NOT_ALLOWED: 1,
  // User is no longer using an ad blocker after seeing the ad blocking message.
  ADS_ALLOWED: 2,
};

googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum{!Object<string, number>}

इससे उपयोगकर्ता के लिए, अमेरिका के अलग-अलग राज्यों के कानूनों के हिसाब से ऑप्ट-आउट करने की स्थिति के बारे में पता चलता है. ये अलग-अलग स्थितियां हो सकती हैं:

googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum = {
  // Something failed, status unknown.
  UNKNOWN: 0,
  // No US state regulation applies to this user.
  DOES_NOT_APPLY: 1,
  // A US state regulation applies to this user, and the user has not opted out yet.
  NOT_OPTED_OUT: 2,
  // A US state regulation applies to this user, and the user has opted out.
  OPTED_OUT: 3,
};

googlefc.GoogleFcConsentModeUserStatus{!Object}

googlefc.getGoogleConsentModeValues फ़ंक्शन से मिले ऑब्जेक्ट का टाइप.

interface GoogleFcConsentModeUserStatus {

  // End user consent decision value for the ad_storage consent mode purpose.
  adStoragePurposeConsentStatus: number;

  // End user consent decision value for the ad_user_data consent mode purpose.
  adUserDataPurposeConsentStatus: number;

  // End user consent decision value for the ad_personalization consent mode purpose.
  adPersonalizationPurposeConsentStatus: number;

  // End user consent decision value for the analytics_storage consent mode purpose.
  analyticsStoragePurposeConsentStatus: number;
}

हर फ़ील्ड की वैल्यू एक संख्या होती है, जो googlefc.ConsentModePurposeStatusEnum enum वैल्यू से मेल खाती है.

googlefc.ConsentModePurposeStatusEnum{!Object<string, number>}

यह कुकी, सहमति मोड के मकसद के लिए, असली उपयोगकर्ता की सहमति की अलग-अलग वैल्यू दिखाती है. अलग-अलग वैल्यू ये हैं:

googlefc.ConsentModePurposeStatusEnum = {
  // Indicates either an error state, or that consent mode data is not ready
  // yet.
  UNKNOWN: 0,
  // Consent is granted for the given consent mode purpose.
  GRANTED: 1,
  // Consent is denied for the given consent mode purpose.
  DENIED: 2,
  // Consent is not applicable for the given consent mode purpose.
  NOT_APPLICABLE: 3,
  // The consent mode purpose has not been configured for use in the Privacy &
  // messaging UI.
  NOT_CONFIGURED: 4
};

googlefc.usstatesoptout.overrideDnsLink{undefined|boolean}

'मेरी निजी जानकारी को न बेचें और न शेयर करें' लिंक को छिपाने और अपने कस्टम लिंक का इस्तेमाल करने के लिए, इस फ़ील्ड को सही पर सेट करें.

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.usstatesoptout = window.googlefc.usstatesoptout || {};
  // Signals that the default DNS link will be overridden.
  googlefc.usstatesoptout.overrideDnsLink = true;
</script>

googlefc.ccpa.InitialCcpaStatusEnum{!Object<string, number>}

googlefc.ccpa.InitialCcpaStatusEnum = {
  // Something failed, in an unknown state.
  UNKNOWN: 0,
  // No US state regulation applies to this user.
  CCPA_DOES_NOT_APPLY: 1,
  // A US state regulation applies to this user, and the user has not opted out yet.
  NOT_OPTED_OUT: 2,
  // A US state regulation applies to this user, and the user has opted out.
  OPTED_OUT: 3,
};

googlefc.ccpa.overrideDnsLink{undefined|boolean}

'मेरी निजी जानकारी को न बेचें और न शेयर करें' लिंक को छिपाने और अपने कस्टम लिंक का इस्तेमाल करने के लिए, इस फ़ील्ड को सही पर सेट करें. ध्यान दें कि इस फ़ील्ड को 'सही' पर सेट करने का मतलब है कि आपको अपनी साइट पर, 'निजी डेटा न बेचें या शेयर न करें' लिंक को रेंडर करना होगा. इस फ़ील्ड का इस्तेमाल, openConfirmationDialog के साथ किया जाना चाहिए.

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {};
  // Signals that the default DNS link will be overridden.
  googlefc.ccpa.overrideDnsLink = true;
</script>

तरीके: जानकारी और उदाहरण

googlefc.getConsentStatus(): {number}

googlefc.getConsentedProviderIds(): {!Array<string>}

अब कॉल करने पर, यह हमेशा एक खाली सूची दिखाता है.

googlefc.showRevocationMessage(): {undefined}

अगर ईयू के कानूनों के मुताबिक सहमति देने का मौजूदा रिकॉर्ड मौजूद है, तो यह कुकी उसे मिटा देती है. साथ ही, ईयू के कानूनों के मुताबिक सहमति देने का मैसेज फिर से दिखाती है, ताकि उपयोगकर्ता सहमति देने के अपने फ़ैसले को बदल सके.

पहला उदाहरण: लिंक सेट अप करने का आसान उदाहरण. इस लिंक पर क्लिक करने पर, सदस्यता रद्द करने का मैसेज दिखेगा:

<a href="javascript:window.googlefc.showRevocationMessage();">Privacy and cookie settings</a>

अहम जानकारी: अगर लिंक पर क्लिक करते समय, googlefc API को पेज पर लोड नहीं किया गया है, तो लिंक पर क्लिक करने से कोई असर नहीं पड़ेगा. आम तौर पर, googlefc API, ज़्यादातर उपयोगकर्ताओं के इस लिंक को ढूंढने और इस पर क्लिक करने से पहले ही पेज पर लोड हो जाता है. हालांकि, अगर आपको यह लिंक सिर्फ़ तब दिखाना है, जब googlefc पेज पर मौजूद हो, तो CONSENT_API_READY एपीआई कुंजी के आधार पर लिंक दिखाने की शर्त तय की जा सकती है. इसके लिए, यहां दिए गए कोड स्निपेट का इस्तेमाल करें.

<a href="javascript:window.googlefc.showRevocationMessage();" style="display: none;" id="revocation-link">Privacy and cookie settings</a>
<script>
  window.googlefc = window.googlefc || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];
  window.googlefc.callbackQueue.push({
    'CONSENT_API_READY':
    () => {
      // Update the revocation link so that it shows on the page.
      const revocationLink = document.getElementById('revocation-link');
      revocationLink.style.display = 'block';
    }
  });
</script>

दूसरा उदाहरण: अगर आपको लिंक सिर्फ़ तब दिखाना है, जब मौजूदा उपयोगकर्ता पर ईयू के कानून लागू होते हैं, तो googlefc कॉलबैक क्यू का इस्तेमाल किया जा सकता है. इसके लिए, टीसीएफ़ एपीआई का इस्तेमाल करें. इससे gdprApplies की वैल्यू तय होने के बाद, बटन को शर्तों के आधार पर दिखाया जा सकेगा. इसके लिए, CONSENT_API_READY एपीआई कुंजी का इस्तेमाल करें.

<a href="javascript:window.googlefc.showRevocationMessage();" style="display: none;" id="revocation-link">Privacy and cookie settings</a>
<script>
  window.googlefc = window.googlefc || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];
  window.googlefc.callbackQueue.push({
    'CONSENT_API_READY':
    // Specifying "0" for the version parameter will result in the API call
    // using the latest version of the TCF spec.
    () => __tcfapi('addEventListener', 0, (tcdata, success) => {
      const revocationLink = document.getElementById('revocation-link');
      if (!success || !tcdata) {
        // Something went wrong, don't show the revocation link.
        revocationLink.style.display = 'none';
      }
      else if (tcdata.gdprApplies) {
        revocationLink.style.display = 'block';
      } else {
        // GDPR does not apply so don't show the revocation link.
        revocationLink.style.display = 'none';
      }
    })
  });
</script>

googlefc.getAdBlockerStatus(): {number}

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

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.usstatesoptout = window.googlefc.usstatesoptout || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY':
    () => {
      switch (googlefc.getAdBlockerStatus()) {
          case googlefc.AdBlockerStatusEnum.EXTENSION_LEVEL_AD_BLOCKER:
          case googlefc.AdBlockerStatusEnum.NETWORK_LEVEL_AD_BLOCKER:
            // Insert handling for cases where the user is blocking ads.
            break;
          case googlefc.AdBlockerStatusEnum.NO_AD_BLOCKER:
            // Insert handling for cases where the user is not blocking ads.
            break;
          case googlefc.AdBlockerStatusEnum.UNKNOWN:
            // Insert handling for unknown cases.
            break;
      }
    }
  });
</script>

googlefc.getAllowAdsStatus(): {number}

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

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.usstatesoptout = window.googlefc.usstatesoptout || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'AD_BLOCK_DATA_READY':
    () => {
      switch (googlefc.getAllowAdsStatus()) {
        case googlefc.AllowAdsStatusEnum.ADS_NOT_ALLOWED:
          // Insert handling for cases where the user has not allowed ads.
          // The user may have never been an ad blocker.
          break;
        case googlefc.AllowAdsStatusEnum.ADS_ALLOWED:
          // Insert handling for cases where the user saw the ad blocking
          // message and allowed ads on the site.
          break;
        case googlefc.AllowAdsStatusEnum.UNKNOWN:
          // Insert handling for unknown cases.
          break;
      }
    }
  });
</script>

googlefc.usstatesoptout.getInitialUsStatesOptOutStatus(): {number}

यह फ़ंक्शन, उपयोगकर्ता के लिए अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने की स्थिति के आधार पर, InitialUsStatesOptOutStatusEnum में वैल्यू दिखाता है. इस फ़ंक्शन के लिए, INITIAL_US_STATES_OPT_OUT_DATA_READY कुंजी का इस्तेमाल किया जाना चाहिए. ध्यान दें कि अमेरिका के राज्यों में लागू निजता कानूनों के तहत तैयार किए गए मैसेज से जुड़े डेटा के लिए, बाद में किए गए किसी भी अनुरोध को सीधे तौर पर GPP API (__gpp) को कॉल करके हासिल किया जाना चाहिए.

'निजी डेटा न बेचें या शेयर न करें' लिंक को बदलने पर, इस तरीके का इस्तेमाल करके यह तय किया जा सकता है कि आपकी साइट पर लिंक कब शामिल करना है.

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.usstatesoptout = window.googlefc.usstatesoptout || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'INITIAL_US_STATES_OPT_OUT_DATA_READY':
    () => {
      switch (googlefc.usstatesoptout.getInitialUsStatesOptOutStatus()) {
        case googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum.DOES_NOT_APPLY:
          // Insert handling for cases where no US state regulation applies to
          // the user.
          break;
        case googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum.NOT_OPTED_OUT:
          // Insert handling for cases where a US state regulation applies to
          // the user, and the user has not opted out.
          break;
        case googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum.OPTED_OUT:
          // Insert handling for cases where a US state regulation applies to the
          // user, and the user has opted out.
          break;
      }
    }
  });
</script>

googlefc.usstatesoptout.openConfirmationDialog(function(boolean)): {undefined}

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

उदाहरण:

<script>
// This callback will be called with the user's US state regulation opt-out
// decision.
const usStateRegCompletionCallback = (userOptedOut) => {
  // Insert handling for user opt-out status here.
}
// Invoke the US state regulations confirmation dialog when the user clicks the
// link.
document.getElementById("your-custom-do-not-sell-link").addEventListener(
  "click", () => googlefc.usstatesoptout.openConfirmationDialog(usStateRegCompletionCallback));
</script>

googlefc.getGoogleConsentModeValues(): {!Object}

यह googlefc.GoogleFcConsentModeUserStatus ऑब्जेक्ट दिखाता है. इसमें सहमति मोड के हर मकसद की मौजूदा वैल्यू होती है. यह वैल्यू, उपयोगकर्ता की सहमति के फ़ैसले पर आधारित होती है.

इस्तेमाल के बारे में जानने के लिए, ईयू के कानूनों के लिए, सहमति मोड के साथ Google के सहमति मैनेजमेंट प्लैटफ़ॉर्म (सीएमपी) का इस्तेमाल करना लेख पढ़ें.

googlefc.ccpa.getInitialCcpaStatus(): {number}

यह फ़ंक्शन, उपयोगकर्ता के लिए अमेरिका के राज्य के कानून के तहत ऑप्ट-आउट करने की स्थिति के आधार पर, InitialCcpaStatusEnum में वैल्यू दिखाता है. इस फ़ंक्शन के लिए, INITIAL_CCPA_DATA_READY को बटन के तौर पर सेट किया जाना चाहिए. ध्यान दें कि अमेरिका के राज्य के कानून से जुड़े डेटा के लिए, इसके बाद किए जाने वाले किसी भी अनुरोध को सीधे तौर पर GPP API (__gpp) को कॉल करके हासिल किया जाना चाहिए.

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.ccpa = window.googlefc.ccpa || {}
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  googlefc.callbackQueue.push({
    'INITIAL_CCPA_DATA_READY':
    () => {
      switch (googlefc.ccpa.getInitialCcpaStatus()) {
        case googlefc.ccpa.InitialCcpaStatusEnum.CCPA_DOES_NOT_APPLY:
          // Insert handling for cases where no US state regulation applies to
          // the user.
          break;
        case googlefc.ccpa.InitialCcpaStatusEnum.NOT_OPTED_OUT:
          // Insert handling for cases where a US state regulation applies to
          // the user, and the user has not opted out.
          break;
        case googlefc.ccpa.InitialCcpaStatusEnum.OPTED_OUT:
          // Insert handling for cases where a US state regulation applies to the
          // user, and the user has opted out.
          break;
      }
    }
  });
</script>

googlefc.ccpa.openConfirmationDialog(function(boolean)): {undefined}

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

उदाहरण:

<script>
// This callback will be called with the user's US state regulation opt-out
// decision.
const usStateRegCompletionCallback = (userOptedOut) => {
  // Insert handling for user opt-out status here.
}
// Invoke the US state regulations confirmation dialog when the user clicks the
// link.
document.getElementById("your-custom-ccpa-do-not-sell-link").addEventListener(
  "click", () => googlefc.ccpa.openConfirmationDialog(ccpaCompletionCallback));
</script>

अगर IAB टीसीएफ़ के दूसरे वर्शन के तहत जीडीपीआर के लिए सहमति लेने के लिए, Google के सहमति मैनेजमेंट प्लैटफ़ॉर्म इस्तेमाल किए जा रहे हैं, तो आपको IAB टीसीएफ़ के दूसरे वर्शन वाले एपीआई का इस्तेमाल करना चाहिए.

CONSENT_API_READY कॉलबैक क्यू की कुंजी का इस्तेमाल करके, यह पक्का किया जा सकता है कि संबंधित कॉलबैक सिर्फ़ तब शुरू हों, जब पेज पर IAB टीसीएफ़ v2 एपीआई तय किया गया हो. इसका इस्तेमाल, IAB टीसीएफ़ के 2.0 वर्शन वाले एपीआई के 'addEventListener' कमांड के साथ किया जाना चाहिए.

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback using the CONSENT_API_READY key on the callbackQueue.
  window.googlefc.callbackQueue.push({
    'CONSENT_API_READY':
    () => __tcfapi('addEventListener', 2.2, (data, success) => {
      // Do something with consent data value; this callback may be invoked
      // multiple times as user completes consent flow.
    })
  });
</script>

CONSENT_DATA_READY कॉलबैक क्यू की का इस्तेमाल करके यह पक्का किया जा सकता है कि इससे जुड़े कॉलबैक सिर्फ़ तब ट्रिगर हों, जब उपयोगकर्ता की सहमति ले ली गई हो और IAB TCF v2 API का इस्तेमाल करके इसे ऐक्सेस किया जा सकता हो. इसका इस्तेमाल 'addEventListener' कमांड के साथ किया जा सकता है. आपके दिए गए कॉलबैक के पहले इनवोकेशन में दिया गया डेटा, उपयोगकर्ता की सहमति से जुड़े विकल्पों के बारे में जानकारी देगा. ऐसा तब तक होगा, जब तक इस उपयोगकर्ता पर टीसीएफ़ v2 लागू होता है. ध्यान दें कि टीसीएफ़ के 2.2 वर्शन के रिलीज़ होने के बाद, 'getTCData' कमांड का इस्तेमाल अब नहीं किया जा सकता.

उदाहरण:

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback using the CONSENT_DATA_READY key on the callbackQueue.
  window.googlefc.callbackQueue.push({
    'CONSENT_DATA_READY':
    () => __tcfapi('addEventListener', 2.2, (data, success) => {
      // Do something with consent data value; this callback may be invoked
      // multiple times if user consent selections change.
    })
  });
</script>

Google के कंसेंट मैनेजमेंट सलूशन, ईयू के कानूनों के तहत उपयोगकर्ताओं की सहमति के विकल्पों को समझ सकते हैं. ये विकल्प, Google के सहमति मोड के लिए होते हैं. इसके बारे में ज़्यादा जानने के लिए, सहायता केंद्र पर जाएं.

सहमति मोड को बेसिक मोड या ऐडवांस मोड में लागू किया जा सकता है. इसके बारे में Google Ads और Analytics के दस्तावेज़ में बताया गया है. आपको अपनी कानूनी ज़रूरतों को पूरा करने के लिए, सहमति मोड के किस वर्शन को लागू करना चाहिए, इस बारे में अपने कानूनी विभाग से सलाह लें.

सहमति मोड का ऐडवांस वर्शन डिफ़ॉल्ट रूप से काम करता है. Privacy & messaging के यूज़र इंटरफ़ेस (यूआई) में सहमति मोड चालू करने के बाद, आपको कुछ और करने की ज़रूरत नहीं होती.

Google के सहमति मैनेजमेंट से जुड़े समाधानों का इस्तेमाल करके, सहमति मोड का बेसिक वर्शन लागू करने के लिए, CONSENT_MODE_DATA_READY कॉलबैक क्यू की का इस्तेमाल किया जा सकता है. इससे, सहमति मोड का डेटा उपलब्ध होने के बाद, Google Ads और Analytics टैग को शर्तों के साथ लोड किया जा सकता है. सहमति मोड का डेटा तब उपलब्ध होगा, जब Funding Choices यह तय कर लेगा कि इस अनुरोध पर सहमति मोड लागू नहीं होता. उदाहरण के लिए, ऐसा इसलिए हो सकता है, क्योंकि ईयू के कानून इस अनुरोध पर लागू नहीं होते. इसके अलावा, यह डेटा तब भी उपलब्ध होगा, जब कोई उपयोगकर्ता ईयू के कानूनों के तहत सहमति देने या न देने का फ़ैसला कर लेगा. सहमति मोड उपलब्ध होने पर, आपके टैग लोड किए जा सकते हैं या नहीं, यह तय करने के लिए इस्तेमाल किए जाने वाले मानदंड के बारे में जानने के लिए, अपने कानूनी विभाग से संपर्क करें.

उदाहरण के लिए, सहमति मोड का डेटा उपलब्ध होने पर अपने टैग लोड करने के लिए, भले ही असली उपयोगकर्ता ने सहमति दी हो या नहीं:

<script>
// Make sure that the properties exist on the window.
window.googlefc = window.googlefc || {};
window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

// Helper function to load Google Ads/Analytics tags once consent mode data is
// ready.
const loadGtagScript = () => {
  // Load gtag.js script - code taken from
  // https://developers.google.com/tag-platform/security/guides/consent?consentmode=basic#set_up_consent_mode
  var gtagScript = document.createElement('script');
  gtagScript.async = true;
  gtagScript.src = 'https://www.googletagmanager.com/gtag/js?id=<Google tag ID>';

  var firstScript = document.getElementsByTagName('script')[0];
  firstScript.parentNode.insertBefore(gtagScript,firstScript);
}

// Queue the callback using the CONSENT_MODE_DATA_READY key on the callbackQueue.
window.googlefc.callbackQueue.push({
  'CONSENT_MODE_DATA_READY':
  () => {
      loadGtagScript();
  },
});
</script>

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

उदाहरण के लिए, googlefc.getGoogleConsentModeValues() का इस्तेमाल करके, Google Ads और Analytics टैग को सिर्फ़ तब अनब्लॉक किया जा सकता है, जब:

असली उपयोगकर्ता, ईयू के कानूनों के मुताबिक सहमति देने का फ़ैसला लेता है. इससे सहमति मोड के सभी मकसद के लिए सहमति मिल जाती है या
सहमति मोड के सभी मकसद, मौजूदा अनुरोध पर लागू नहीं होते. ऐसा तब हो सकता है, जब ईयू के कानून लागू न हों या निजता और मैसेज सेवा में, एक या उससे ज़्यादा मकसद के लिए सहमति मोड कॉन्फ़िगर न किया गया हो.

<script>
// Make sure that the properties exist on the window.
window.googlefc = window.googlefc || {};
window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

// Helper function to determine whether Google Ads and Analytics tags can be
// unblocked. Returns true if all consent mode purposes are set to GRANTED,
// NOT_APPLICABLE, or NOT_CONFIGURED.
const shouldUnblockConsentTags = (googleFcConsentModeStatus) => {
  const allConsentModeValues = [
    googleFcConsentModeStatus.adStoragePurposeConsentStatus,
    googleFcConsentModeStatus.adUserDataPurposeConsentStatus,
    googleFcConsentModeStatus.adPersonalizationPurposeConsentStatus,
    googleFcConsentModeStatus.analyticsStoragePurposeConsentStatus
  ];
  for (const consentModeValue of allConsentModeValues) {
    switch (consentModeValue) {
      case googlefc.ConsentModePurposeStatusEnum.CONSENT_MODE_PURPOSE_STATUS_UNKNOWN:
        // Indicates either an error case or that consent mode data is not
        // ready yet. Cannot unblock tags until consent data is ready and valid,
        // so return false.
        return false;
      case googlefc.ConsentModePurposeStatusEnum.CONSENT_MODE_PURPOSE_STATUS_GRANTED:
        // Consent is granted for this consent mode purpose.
        break;
      case googlefc.ConsentModePurposeStatusEnum.CONSENT_MODE_PURPOSE_STATUS_DENIED:
        // Consent is denied for this consent mode purpose. Do not unblock tags.
        return false;
      case googlefc.ConsentModePurposeStatusEnum.CONSENT_MODE_PURPOSE_STATUS_NOT_APPLICABLE:
        // Consent mode does not apply for this purpose.
        break;
      case googlefc.ConsentModePurposeStatusEnum.CONSENT_MODE_PURPOSE_STATUS_NOT_CONFIGURED:
        // Consent mode not configured for this purpose.
        // If you configured support for Ads purposes but not Analytics purposes in the
        // Privacy & messaging UI, the value of `analyticsStoragePurposeConsentStatus` will
        // always be set to NOT_CONFIGURED. If you do not enable any Consent Mode support
        // in the Privacy & messaging UI, the values of all purposes will always be set to
        // NOT_CONFIGURED.
        break;
      default:
        console.log("Unexpected consent mode value encountered");
    }
  }
  // If all prior checks pass, all consent mode values are either GRANTED,
  // NOT_APPLICABLE, or NOT_CONFIGURED.
  return true;
};

// Helper function to load Google Ads/Analytics tags.
const loadGtagScript = () => {
  // Load gtag.js script - code taken from
  // https://developers.google.com/tag-platform/security/guides/consent?consentmode=basic#set_up_consent_mode
  var gtagScript = document.createElement('script');
  gtagScript.async = true;
  gtagScript.src = 'https://www.googletagmanager.com/gtag/js?id=<Google tag ID>';

  var firstScript = document.getElementsByTagName('script')[0];
  firstScript.parentNode.insertBefore(gtagScript,firstScript);
}

googlefc.callbackQueue.push({
  CONSENT_MODE_DATA_READY: () => {
    if (shouldUnblockConsentTags(googlefc.getGoogleConsentModeValues())) {
      loadGtagScript();
    }
  },
});
</script>

अगर IAB GPP फ़्रेमवर्क के तहत, अमेरिका के राज्यों में लागू निजता कानूनों के मुताबिक, उपयोगकर्ताओं को ऑप्ट-आउट करने के मैसेज दिखाने के लिए, Google के सहमति मैनेजमेंट से जुड़े समाधानों का इस्तेमाल किया जा रहा है, तो आपको IAB GPP API का इस्तेमाल करना चाहिए.

अमेरिका के राज्यों के कानूनों के तहत, ऑप्ट आउट करने की सुविधा उपलब्ध होती है. इसलिए, CONSENT_API_READY या CONSENT_DATA_READY कॉलबैक कतार की कुंजी का इस्तेमाल किया जा सकता है. इससे यह पक्का किया जा सकता है कि IAB GPP API को कॉल किया जा सकता है और कॉलबैक शुरू होने के समय, सहमति से जुड़ा डेटा वापस मिल रहा है.

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.usstatesoptout = window.googlefc.usstatesoptout || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Queue the callback on the callbackQueue.
  window.googlefc.callbackQueue.push({
    'CONSENT_DATA_READY':
    () => __gpp('ping', (data, success) => {
        // Do something with consent data value.
    })
  });
</script>

अगर IAB GPP फ़्रेमवर्क के तहत, अमेरिका के राज्यों में लागू निजता कानूनों के मुताबिक, उपयोगकर्ताओं को ऑप्ट-आउट करने के मैसेज दिखाने के लिए Google के सहमति मैनेजमेंट से जुड़े समाधानों का इस्तेमाल किया जा रहा है, तो आपके पास 'बेचें या शेयर न करें' लिंक को अपनी पसंद के मुताबिक बनाने का विकल्प होता है. इसके लिए, googlefc.usstatesoptout.overrideDnsLink फ़्लैग को true पर सेट करें.

<script>
  // Make sure that the properties exist on the window.
  window.googlefc = window.googlefc || {};
  window.googlefc.usstatesoptout = window.googlefc.usstatesoptout || {};
  window.googlefc.callbackQueue = window.googlefc.callbackQueue || [];

  // Signals that the default DNS link will be overridden.
  window.googlefc.usstatesoptout.overrideDnsLink = true;

  // Register the callback for the initial US state regulations data.
  window.googlefc.callbackQueue.push({
      'INITIAL_US_STATES_OPT_OUT_DATA_READY': () => {
        if (googlefc.usstatesoptout.getInitialUsStatesOptOutStatus() ===
            googlefc.usstatesoptout.InitialUsStatesOptOutStatusEnum.NOT_OPTED_OUT) {
          // TODO: Display custom Do Not Sell or Share link here.
        }
      }
    });
</script>

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

ध्यान दें कि 'मेरी निजी जानकारी न बेचें या शेयर न करें' लिंक का इस्तेमाल करते समय, यह पक्का करना आपकी ज़िम्मेदारी है कि आपका लिंक, अमेरिका के राज्य के नियमों का पालन करता हो.

<script>
// This callback will be called when the user makes a US state regulations
// decision.
const usStateRegCompletionCallback = (userOptedOut) => {
  if (userOptedOut) {
    // TODO: Hide custom Do Not Sell or Share link here.
  }
}
// Invoke the US state regulations opt-out confirmation dialog when the user
// clicks the link.
document.getElementById("your-custom-do-not-sell-link").addEventListener(
  "click", () => googlefc.usstatesoptout.openConfirmationDialog(usStateRegCompletionCallback));
</script>

परिचय

फ़ील्ड की खास जानकारी

तरीकों के बारे में खास जानकारी

अपनी साइट पर टेस्टिंग और डीबग करना

फ़ील्ड: जानकारी और उदाहरण

तरीके: जानकारी और उदाहरण

GDPR के लिए, IAB टीसीएफ़ के 2.0 वर्शन के साथ Google के सहमति मैनेजमेंट से जुड़े समाधानों का इस्तेमाल करना

ईयू के कानूनों के लिए, सहमति मोड के साथ Google के सहमति मैनेजमेंट प्लैटफ़ॉर्म (सीएमपी) का इस्तेमाल करना