सहमति मोड वाला टेंप्लेट बनाना

यह दस्तावेज़ उन डेवलपर के लिए है जो Google Tag Manager (GTM) का इस्तेमाल करने वाली वेबसाइटों पर, सहमति मैनेजमेंट से जुड़ा समाधान बनाए रखते हैं.

इस पेज पर, Google Tag Manager में सहमति टाइप के बारे में बताया गया है. साथ ही, इन्हें सहमति मैनेजमेंट से जुड़े समाधान के साथ इंटिग्रेट करने का तरीका बताया गया है.

सहमति की स्थिति और सहमति के टाइप

Google और तीसरे पक्ष के टैग, granted या denied के consent state के आधार पर, स्टोरेज के तरीके में बदलाव करते हैं. इनमें, यहां दिए गए किसी भी सहमति के टाइप के लिए, सहमति की जांच करने की सुविधा पहले से मौजूद हो सकती है:

सहमति लेने के लिए नया टेंप्लेट बनाना

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

• gtag consent के बजाय, Tag Manager के सहमति मोड वाले एपीआई setDefaultConsentState और updateConsentState का इस्तेमाल करें.

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

• सीएमपी को वेबसाइट पर आने वाले व्यक्ति को जल्द से जल्द यह सूचना देनी होगी कि वह सहमति दे या अस्वीकार करे. यह सूचना, सहमति के सभी लागू टाइप के लिए होनी चाहिए.

• जब वेबसाइट पर आने वाला कोई व्यक्ति अपनी सहमति के बारे में बताता है, तो सीएमपी को सहमति की अपडेट की गई स्थिति को पास करना होता है.

1. नया टेंप्लेट बनाना

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

सहमति लेने के लिए टेंप्लेट बनाने का तरीका:

1. अपने Google Tag Manager खाते में लॉग इन करें.
2. बाईं ओर मौजूद नेविगेशन में, टेंप्लेट चुनें.
3. टैग टेंप्लेट पैनल में, नया पर क्लिक करें.

सहमति की डिफ़ॉल्ट स्थितियां सेट करने के लिए:

1. फ़ील्ड टैब को चुनें. इसके बाद, फ़ील्ड जोड़ें > पैरामीटर टेबल पर क्लिक करें.
2. नाम बदलकर defaultSettings कर दें.
3. फ़ील्ड को बड़ा करें.
4. डिसप्ले नेम को Default settings पर अपडेट करें.
5. कॉलम जोड़ें पर क्लिक करें. इसके बाद, टेक्स्ट इनपुट चुनें. नाम को बदलकर region करें और कॉलम की वैल्यू यूनीक होनी चाहिए बॉक्स पर सही का निशान लगाएं.
6. कॉलम को बड़ा करें और डिसप्ले नेम को Region (leave blank to have consent apply to all regions) में बदलें. ब्रैकेट में दिया गया स्टेटमेंट, आपके टेंप्लेट का इस्तेमाल करने वाले लोगों के लिए दस्तावेज़ है. अलग-अलग देशों/इलाकों के लिए, सहमति की डिफ़ॉल्ट स्थिति सेट अप करने के बारे में ज़्यादा जानें.
7. कॉलम जोड़ें पर क्लिक करें. इसके बाद, टेक्स्ट इनपुट को चुनें और नाम को granted में बदलें.
8. कॉलम को बड़ा करें और डिसप्ले नेम को Granted Consent Types (comma separated) में बदलें.
9. कॉलम जोड़ें पर क्लिक करें. इसके बाद, टेक्स्ट इनपुट को चुनें और नाम को denied में बदलें.
10. कॉलम को बड़ा करें और डिसप्ले नेम को Denied Consent Types (comma separated) में बदलें

ज़रूरी नहीं: विज्ञापनों के डेटा को छिपाने की सुविधा जोड़ने के लिए:

1. फ़ील्ड जोड़ें पर क्लिक करें. इसके बाद, चेकबॉक्स चुनें और फ़ील्ड का नाम बदलकर ads_data_redaction करें.
2. डिसप्ले नेम को Redact Ads Data पर अपडेट करें

विज्ञापनों के डेटा को हटाने की सुविधा के साथ कुकी के काम करने के तरीके के बारे में ज़्यादा जानें

ज़रूरी नहीं: यूआरएल पैरामीटर पास करने की सुविधा जोड़ने के लिए:

1. फ़ील्ड जोड़ें पर क्लिक करें. इसके बाद, चेकबॉक्स चुनें और फ़ील्ड का नाम बदलकर url_passthrough करें.
2. डिसप्ले नेम को Pass through URL parameters पर अपडेट करें

यूआरएल पैरामीटर पास करने के बारे में ज़्यादा जानें

लागू करने का कोड जोड़ने के लिए:

1. टेम्प्लेट एडिटर में कोड टैब खोलें.
2. यहां दिए गए कोड सैंपल में, प्लेसहोल्डर फ़ील्ड में बदलाव करें.
3. कोड को कॉपी करें और टेंप्लेट एडिटर में मौजूद बॉयलरप्लेट कोड को इससे बदलें.
4. टेंप्लेट को सेव करें.

// The first two lines are optional, use if you want to enable logging
const log = require('logToConsole');
log('data =', data);
const setDefaultConsentState = require('setDefaultConsentState');
const updateConsentState = require('updateConsentState');
const getCookieValues = require('getCookieValues');
const callInWindow = require('callInWindow');
const gtagSet = require('gtagSet');
const JSON = require('JSON');
const COOKIE_NAME = 'Your_cookie_name';
/*
 *   Splits the input string using comma as a delimiter, returning an array of
 *   strings
 */
const splitInput = (input) => {
  if (!input) return [];
  return input.split(',')
      .map(entry => entry.trim())
      .filter(entry => entry.length !== 0);
};
/*
 *   Processes a row of input from the default settings table, returning an object
 *   which can be passed as an argument to setDefaultConsentState
 */
const parseCommandData = (settings) => {
  const regions = splitInput(settings['region']);
  const granted = splitInput(settings['granted']);
  const denied = splitInput(settings['denied']);
  const commandData = {};
  if (regions.length > 0) {
    commandData.region = regions;
  }
  granted.forEach(entry => {
    commandData[entry] = 'granted';
  });
  denied.forEach(entry => {
    commandData[entry] = 'denied';
  });
  return commandData;
};
/*
 *   Called when consent changes. Assumes that consent object contains keys which
 *   directly correspond to Google consent types.
 */
const onUserConsent = (consent) => {
  const consentModeStates = {
    ad_storage: consent['adConsentGranted'] ? 'granted' : 'denied',
    ad_user_data: consent['adUserDataConsentGranted'] ? 'granted' : 'denied',
    ad_personalization: consent['adPersonalizationConsentGranted'] ? 'granted' : 'denied',
    analytics_storage: consent['analyticsConsentGranted'] ? 'granted' : 'denied',
    functionality_storage: consent['functionalityConsentGranted'] ? 'granted' : 'denied',
    personalization_storage: consent['personalizationConsentGranted'] ? 'granted' : 'denied',
    security_storage: consent['securityConsentGranted'] ? 'granted' : 'denied',
  };
  updateConsentState(consentModeStates);
};
/*
 *   Executes the default command, sets the developer ID, and sets up the consent
 *   update callback
 */
const main = (data) => {
  /*
   * Optional settings using gtagSet
   */
  gtagSet('ads_data_redaction', data.ads_data_redaction);
  gtagSet('url_passthrough', data.url_passthrough);
  gtagSet('developer_id.your_developer_id', true);
  // Set default consent state(s). Add optional chaining to safely handle cases
  // where defaultSettings might be null or undefined.
  data.defaultSettings?.forEach(settings => {
    const defaultData = parseCommandData(settings);
    // wait_for_update (ms) allows for time to receive visitor choices from the CMP
    defaultData.wait_for_update = 500;
    setDefaultConsentState(defaultData);
  });

  // Check if cookie is set and has values that correspond to Google consent
  // types. If it does, run onUserConsent().
  const cookieValues = getCookieValues(COOKIE_NAME);
  if (cookieValues && cookieValues.length > 0) {
    try {
      const settings = JSON.parse(cookieValues[0]);
      if (settings) {
        onUserConsent(settings);
      }
    } catch (e) {
      // Log an error if the cookie value is not valid JSON.
    }
  }
  /**
   *   Add event listener to trigger update when consent changes
   *
   *   References an external method on the window object which accepts a
   *   function as an argument. If you do not have such a method, you will need
   *   to create one before continuing. This method should add the function
   *   that is passed as an argument as a callback for an event emitted when
   *   the user updates their consent. The callback should be called with an
   *   object containing fields that correspond to the five built-in Google
   *   consent types.
   */
  callInWindow('addConsentListenerExample', onUserConsent);
};
main(data);
data.gtmOnSuccess();

इसके बाद, सहमति की स्थिति और कुकी को ऐक्सेस करने के लिए अनुमतियां कॉन्फ़िगर करें.

सहमति की स्थितियों को मैनेज करने की अनुमतियां जोड़ने के लिए:

1. अनुमतियां टैब को चुनें. इसके बाद, सहमति की स्थिति ऐक्सेस करता है पर क्लिक करें.
2. सहमति का टाइप जोड़ें पर क्लिक करें.
3. बॉक्स पर क्लिक करें और ड्रॉप-डाउन मेन्यू से ad_storage चुनें.
4. लिखें पर सही का निशान लगाएं.
5. जोड़ें पर क्लिक करें.
6. ad_user_data, ad_personalization, और analytics_storage के लिए, दूसरा से पांचवां चरण दोहराएं. अगर आपको सहमति के अन्य टाइप जोड़ने हैं, तो उन्हें इसी तरीके से जोड़ें.
7. सेव करें पर क्लिक करें.

कुकी ऐक्सेस करने की अनुमतियां जोड़ने के लिए:

1. अनुमतियां टैब को चुनें. इसके बाद, Reads cookie value(s) पर क्लिक करें.
2. खास सेक्शन में, उन सभी कुकी के नाम डालें जिन्हें आपके कोड को उपयोगकर्ता की सहमति के विकल्पों के बारे में जानने के लिए पढ़ना है. हर लाइन में एक नाम डालें.
3. सेव करें पर क्लिक करें.

2. यूनिट टेस्ट बनाना

अपने टेंप्लेट के लिए टेस्ट बनाने के बारे में जानकारी पाने के लिए, टेस्ट पर जाएं.

3. टेंप्लेट को सहमति मैनेजमेंट प्लैटफ़ॉर्म (सीएमपी) के साथ इंटिग्रेट करना

यहां दिए गए कोड में, यह बताया गया है कि लिसनर जोड़कर, इस टेंप्लेट को सहमति मैनेज करने के समाधान के कोड के साथ कैसे इंटिग्रेट किया जा सकता है:

// Array of callbacks to be executed when consent changes
const consentListeners = [];

/**
 *   Called from GTM template to set callback to be executed when user consent is provided.
 *   @param {function} Callback to execute on user consent
 */
window.addConsentListenerExample = (callback) => {
  consentListeners.push(callback);
};

/**
 *   Called when user grants/denies consent.
 *   @param {Object} Object containing user consent settings.
 */
const onConsentChange = (consent) => {
  consentListeners.forEach((callback) => {
    callback(consent);
  });
};

सहमति की स्थिति अपडेट करना

जब वेबसाइट पर आने वाला कोई व्यक्ति, सहमति वाले बैनर के साथ इंटरैक्ट करके अपनी सहमति के विकल्प चुन लेता है, तब टेंप्लेट कोड को updateConsentState API की मदद से, सहमति की स्थितियों को अपडेट करना चाहिए.

यहां दिए गए उदाहरण में, उस व्यक्ति के लिए updateConsentState कॉल दिखाया गया है जिसने सभी स्टोरेज टाइप के लिए सहमति दी है. इस उदाहरण में, granted के लिए हार्डकोड की गई वैल्यू का इस्तेमाल किया गया है. हालांकि, असल में इन्हें रनटाइम पर तय किया जाना चाहिए. इसके लिए, सीएमपी के ज़रिए इकट्ठा की गई विज़िटर की सहमति का इस्तेमाल किया जाना चाहिए.

const updateConsentState = require('updateConsentState');

updateConsentState({
  'ad_storage': 'granted',
  'ad_user_data': 'granted',
  'ad_personalization': 'granted',
  'analytics_storage': 'granted',
  'functionality_storage': 'granted',
  'personalization_storage': 'granted',
  'security_storage': 'granted'
});

देश/इलाके के हिसाब से व्यवहार के बारे में जानकारी

अगर आपको कुछ खास इलाकों से आने वाले लोगों के लिए, सहमति की डिफ़ॉल्ट स्थितियां सेट करनी हैं, तो टेंप्लेट में आईएसओ 3166-2 के हिसाब से कोई क्षेत्र तय करें. रीजन की वैल्यू का इस्तेमाल करने से, टेंप्लेट का इस्तेमाल करने वाले लोग या कंपनियां, इलाके के नियमों का पालन कर पाती हैं. साथ ही, उन्हें उन इलाकों से बाहर के लोगों की जानकारी भी मिलती रहती है. अगर setDefaultConsentState कमांड में किसी क्षेत्र के बारे में नहीं बताया गया है, तो वैल्यू अन्य सभी क्षेत्रों पर लागू होती है.

उदाहरण के लिए, यहां दिया गया कोड स्पेन और अलास्का से आने वाले लोगों के लिए, analytics_storage का डिफ़ॉल्ट स्टेटस denied पर सेट करता है. साथ ही, अन्य सभी लोगों के लिए analytics_storage का स्टेटस granted पर सेट करता है:

const setDefaultConsentState = require('setDefaultConsentState');

setDefaultConsentState({
  'analytics_storage': 'denied',
  'region': ['ES', 'US-AK']
});
setDefaultConsentState({
  'analytics_storage': 'granted'
});

सबसे खास लेवल को प्राथमिकता दी जाती है

अगर एक ही पेज पर, सहमति से जुड़े दो डिफ़ॉल्ट निर्देश मौजूद हैं और उनमें किसी देश/इलाके और उप-इलाके के लिए वैल्यू दी गई हैं, तो ज़्यादा सटीक देश/इलाके के लिए दिए गए निर्देश लागू होंगे. उदाहरण के लिए, अगर आपने US क्षेत्र के लिए ad_storage को 'granted' पर सेट किया है और US-CA क्षेत्र के लिए ad_storage को 'denied' पर सेट किया है, तो कैलिफ़ोर्निया से आने वाले व्यक्ति के लिए, US-CA सेटिंग लागू होगी.

अन्य मेटाडेटा

नीचे दिए गए वैकल्पिक पैरामीटर सेट करने के लिए, gtagSet एपीआई का इस्तेमाल किया जा सकता है:

• url_passthrough
• ads_data_redaction
• developer_id

ये एपीआई, सिर्फ़ GTM टेंप्लेट के सैंडबॉक्स एनवायरमेंट में उपलब्ध होते हैं.

यूआरएल में विज्ञापन पर क्लिक, क्लाइंट आईडी, और सेशन आईडी की जानकारी पास करना

जब कोई व्यक्ति, विज्ञापन पर क्लिक करने के बाद विज्ञापन देने वाले व्यक्ति या कंपनी की वेबसाइट पर जाता है, तो विज्ञापन के बारे में जानकारी को लैंडिंग पेज के यूआरएल में क्वेरी पैरामीटर के तौर पर जोड़ा जा सकता है. कन्वर्ज़न मेज़रमेंट को ज़्यादा सटीक बनाने के लिए, Google टैग आम तौर पर इस जानकारी को विज्ञापन देने वाले व्यक्ति या कंपनी के डोमेन पर पहले-पक्ष की कुकी में सेव करते हैं.

हालांकि, अगर ad_storage की वैल्यू denied है, तो Google टैग इस जानकारी को स्थानीय तौर पर सेव नहीं करेंगे. इस मामले में, विज्ञापन पर क्लिक मेज़रमेंट की क्वालिटी को बेहतर बनाने के लिए, विज्ञापन देने वाले लोग या कंपनियां, यूआरएल पैरामीटर के ज़रिए विज्ञापन पर क्लिक की जानकारी भेज सकती हैं. इसके लिए, उन्हें यूआरएल पासथ्रू नाम की सुविधा का इस्तेमाल करना होगा.

इसी तरह, अगर analytics_storage को 'अनुमति नहीं दी गई' पर सेट किया जाता है, तो यूआरएल पासथ्रू का इस्तेमाल किया जा सकता है. इससे अलग-अलग पेजों पर कुकी के बिना, इवेंट और सेशन पर आधारित आंकड़ों (इसमें कन्वर्ज़न भी शामिल हैं) को भेजा जा सकता है.

यूआरएल पासथ्रू का इस्तेमाल करने के लिए, ये शर्तें पूरी करना ज़रूरी है:

• पेज पर सहमति वाले Google टैग मौजूद हैं.
• साइट ने बिना अनुमति वाले ग्राहकों को भी यूआरएल का ऐक्सेस देने की सुविधा के लिए ऑप्ट-इन किया हो.
• पेज पर सहमति मोड लागू किया गया है.
• आउटगोइंग लिंक, मौजूदा पेज के डोमेन से मेल खाने वाले डोमेन पर ले जाता है.
• यूआरएल में gclid/dclid मौजूद है (सिर्फ़ Google Ads और Floodlight टैग के लिए)

आपके टेंप्लेट में, टेंप्लेट का इस्तेमाल करने वाले व्यक्ति को यह कॉन्फ़िगर करने की अनुमति होनी चाहिए कि उसे यह सेटिंग चालू करनी है या नहीं. url_passthrough को सही पर सेट करने के लिए, इस टेंप्लेट कोड का इस्तेमाल किया जाता है:

gtagSet('url_passthrough', true);

विज्ञापनों का डेटा छिपाना

ad_storage को अस्वीकार करने पर, विज्ञापन के मकसद से कोई नई कुकी सेट नहीं की जाती. इसके अलावा, google.com और doubleclick.net पर पहले से सेट की गई तीसरे पक्ष की कुकी का इस्तेमाल नहीं किया जाएगा. Google को भेजे गए डेटा में अब भी पेज का पूरा यूआरएल शामिल होगा. साथ ही, इसमें यूआरएल पैरामीटर में मौजूद, विज्ञापन पर क्लिक की जानकारी भी शामिल होगी.

अगर ad_storage को अस्वीकार कर दिया जाता है, तो अपने विज्ञापनों के डेटा को और ज़्यादा छिपाने के लिए, ads_data_redaction को 'true' पर सेट करें.

अगर ads_data_redaction की वैल्यू true है और ad_storage की वैल्यू denied है, तो Google Ads और Floodlight टैग से नेटवर्क अनुरोधों में भेजे गए विज्ञापन पर क्लिक करने वाले लोगों के आइडेंटिफ़ायर को छिपा दिया जाएगा.

gtagSet('ads_data_redaction', true);

डेवलपर आईडी

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

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

gtagSet('developer_id.<your_developer_id>', true);

अपने उपयोगकर्ताओं के लिए दस्तावेज़ उपलब्ध कराना

आपके उपयोगकर्ता, सहमति लेने वाले टैग को सेट अप करने के लिए, सहमति वाले टेंप्लेट का इस्तेमाल करेंगे. अपने उपयोगकर्ताओं के लिए ऐसा दस्तावेज़ उपलब्ध कराएं जिसमें इन सबसे सही तरीकों के बारे में बताया गया हो:

• सेटिंग टेबल में, सहमति की डिफ़ॉल्ट स्थितियां सेट करने का तरीका.
• टेबल में अतिरिक्त लाइनें जोड़कर, अलग-अलग देशों/इलाकों के लिए सहमति की डिफ़ॉल्ट स्थितियां सेट अप करने का तरीका.
• टैग को सहमति की प्रोसेस को चालू करने वाला ट्रिगर - सभी पेज ट्रिगर पर ट्रिगर करें.

अगले चरण

अगर आपको अपना टेम्प्लेट, Tag Manager के सभी उपयोगकर्ताओं के लिए उपलब्ध कराना है, तो उसे समुदाय टेम्प्लेट गैलरी में अपलोड करें.