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

gtag का इस्तेमाल करने की तरह ही, Google Analytics मेज़रमेंट प्रोटोकॉल का इस्तेमाल करके, यूज़र आईडी के साथ-साथ उपयोगकर्ता से मिला डेटा भी भेजा जा सकता है. इसका इस्तेमाल, उपयोगकर्ता के व्यवहार और कन्वर्ज़न मेज़रमेंट को बेहतर बनाने के लिए किया जा सकता है.

मेज़रमेंट प्रोटोकॉल के अनुरोध के साथ उपयोगकर्ता से मिला डेटा भेजने के लिए, JSON पेलोड में user_data पैरामीटर जोड़ें. हमारा सुझाव है कि जब भी user_data दिया जाए, तब user_id पैरामीटर भी शामिल करें. इससे यह पक्का करने में मदद मिलती है कि मेज़रमेंट और सुविधा की परफ़ॉर्मेंस सबसे सटीक हो.

मेज़रमेंट प्रोटोकॉल, नॉर्मलाइज़ेशन और हैशिंग के लिए उन्हीं नियमों का इस्तेमाल करता है जिनका इस्तेमाल Data Manager API और Google Ads की बेहतर कन्वर्ज़न ट्रैकिंग के लिए किया जाता है. गोपनीयता से जुड़ी चिंताओं के लिए, ईमेल पते, फ़ोन नंबर, नाम, सरनेम, और मोहल्ले के पते को अपलोड करने से पहले, SHA-256 एल्गोरिदम का इस्तेमाल करके हैश करना ज़रूरी है. हैश वैल्यू को हेक्स स्ट्रिंग फ़ॉर्मैट में कोड किया जाना चाहिए. यह स्ट्रिंग ऑब्जेक्ट होता है, जिसमें सिर्फ़ हेक्साडेसिमल अंक होते हैं, जैसे कि 88d7ecb5c5b21d7b1.

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

  • शुरू या आखिर में मौजूद व्हाइटस्पेस हटाएं.
  • टेक्स्ट को अंग्रेज़ी के छोटे अक्षरों में बदलें.
  • फ़ोन नंबरों को E164 स्टैंडर्ड वाले फ़ॉर्मैट के हिसाब से रखें.
  • gmail.com और googlemail.com वाले ईमेल पतों में, डोमेन नेम से पहले आने वाले सभी पीरियड (.) हटा दें.

JSON पोस्ट बॉडी

कुंजी टाइप ब्यौरा
user_id (ज़रूरी नहीं, लेकिन इसका सुझाव दिया जाता है) स्ट्रिंग किसी उपयोगकर्ता के लिए यूनीक आइडेंटिफ़ायर. इस आइडेंटिफ़ायर के बारे में ज़्यादा जानकारी के लिए, क्रॉस-प्लैटफ़ॉर्म विश्लेषण के लिए यूज़र आईडी देखें.
user_data ऑब्जेक्ट उपयोगकर्ता की पहचान करने वाले, बेहतर उपयोगकर्ता डेटा फ़ील्ड.
user_data.sha256_email_address[] स्ट्रिंग अरै उपयोगकर्ता का हैश और एन्कोड किया गया ईमेल पता. इस तरह से सामान्य किया गया:
user_data.sha256_phone_number[] स्ट्रिंग अरै उपयोगकर्ता का हैश और एन्कोड किया गया फ़ोन नंबर. इस तरह से सामान्य किया गया:
  • सभी नॉन-डिजिट वर्ण हटाएं
  • + प्रीफ़िक्स जोड़ें
  • SHA256 एल्गोरिदम का इस्तेमाल करके हैश करना
  • हेक्स स्ट्रिंग फ़ॉर्मैट का इस्तेमाल करके एन्कोड करें.
user_data.address[] श्रेणी यह कुकी, उपयोगकर्ता की जगह की जानकारी के आधार पर उसकी पहचान करती है.
user_data.address[].sha256_first_name स्ट्रिंग उपयोगकर्ता का हैश किया गया और कोड में बदला गया नाम. इस तरह से सामान्य किया गया:
  • अंक और सिंबल वाले वर्ण हटाएं
  • लोअरकेस
  • शुरुआत और आखिर के स्पेस हटाएं
  • SHA256 एल्गोरिदम का इस्तेमाल करके हैश करना
  • हेक्स स्ट्रिंग फ़ॉर्मैट का इस्तेमाल करके एन्कोड करें.
user_data.address[].sha256_last_name स्ट्रिंग उपयोगकर्ता का हैश और एन्कोड किया गया सरनेम. इस तरह से सामान्य किया गया:
  • अंक और सिंबल वाले वर्ण हटाएं
  • लोअरकेस
  • शुरुआत और आखिर के स्पेस हटाएं
  • SHA256 एल्गोरिदम का इस्तेमाल करके हैश करना
  • हेक्स स्ट्रिंग फ़ॉर्मैट में एन्कोड करें.
user_data.address[].sha256_street स्ट्रिंग उपयोगकर्ता के पते में मौजूद सड़क का नाम और नंबर, जिसे हैश और कोड में बदला गया है. इस तरह से सामान्य किया गया:
  • सिंबल वाले वर्ण हटाएं
  • लोअरकेस
  • शुरुआत और आखिर के स्पेस हटाएं
  • SHA256 एल्गोरिदम का इस्तेमाल करके हैश करना
  • हेक्स स्ट्रिंग फ़ॉर्मैट का इस्तेमाल करके एन्कोड करें.
user_data.address[].city स्ट्रिंग उपयोगकर्ता के पते का शहर. इस तरह से सामान्य किया गया:
  • अंक और सिंबल वाले वर्ण हटाएं
  • लोअरकेस
  • शुरुआत और आखिर के स्पेस हटाएं.
user_data.address[].region स्ट्रिंग उपयोगकर्ता के पते का राज्य या इलाका. इस तरह से सामान्य किया गया:
  • अंक और सिंबल वाले वर्ण हटाएं
  • लोअरकेस
  • शुरुआत और आखिर के स्पेस हटाएं.
user_data.address[].postal_code स्ट्रिंग उपयोगकर्ता के पते का पिन कोड. इस तरह से सामान्य किया गया:
  • . और ~ वर्ण हटाएं
  • शुरुआत और आखिर के स्पेस हटाएं.
user_data.address[].country स्ट्रिंग उपयोगकर्ता के पते के लिए देश का कोड. ISO 3166-1 alpha-2 स्टैंडर्ड के मुताबिक फ़ॉर्मैट किया गया हो.

ट्रांसपोर्ट और पेलोड को फ़ॉर्मैट करने के तरीके के बारे में ज़्यादा जानने के लिए, मेज़रमेंट प्रोटोकॉल का रेफ़रंस दस्तावेज़ देखें.

उपयोगकर्ता से मिला डेटा भेजना

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

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

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

Node.js

const { subtle } = require('crypto').webcrypto;

async function populateSensitiveUserData(value) {
  const encoder = new TextEncoder();
  // Convert a string value to UTF-8 encoded text.
  const valueUtf8 = encoder.encode(value);
  // Compute the hash (digest) using the SHA-256 algorithm.
  const hashSha256 = await subtle.digest('SHA-256', valueUtf8);
  // Convert buffer to byte array.
  const hashArray = Array.from(new Uint8Array(hashSha256));
  // Return a hex-encoded string.
  return hashArray.map(b => b.toString(16).padStart(2, "0")).join('');
};

// Test the encryption function by calling it.
async function main() {
  return await populateSensitiveUserData('<value>');
}

main()
  .then(v => console.log(v))
  .catch(err => console.error(err));

शॉर्टकट के तौर पर, user_data ऑब्जेक्ट में मौजूद सभी दोहराए गए फ़ील्ड (जैसे, address, sha256_email_address, sha256_phone_number) को कलेक्शन के बजाय, एक वैल्यू के तौर पर पास किया जा सकता है.

नीचे दिया गया सैंपल कोड, मेज़रमेंट प्रोटोकॉल को कॉल करता है और User-ID के साथ उपयोगकर्ता का डेटा पास करता है.

Node.js

const measurementId = "MEASUREMENT_ID";
const apiSecret = "API_SECRET";

// Populate mock User Data using the `populateSensitiveUserData` function defined
// above.
const yourEmailSha256Variable = await populateSensitiveUserData('test@yourdomain.com');
const yourPhoneSha256Variable  = await populateSensitiveUserData('+15555555555');
const yourFirstNameSha256Variable  = await populateSensitiveUserData('john');
const yourLastNameSha256Variable  = await populateSensitiveUserData('doe');
const yourStreetAddressSha256Variable  = await populateSensitiveUserData('123 main street');

// Populate mock unencrypted user data.
const yourCityVariable = 'san francisco';
const yourRegionVariable = 'california';
const yourPostalCodeVariable = '94000';
const yourCountryVariable = 'US';

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    client_id: "CLIENT_ID",
    user_id: "USER_ID",
    events: [{
      name: "purchase"
    }],
    user_data: {
      sha256_email_address: yourEmailSha256Variable,
      sha256_phone_number: yourPhoneSha256Variable,
      address: {
        sha256_first_name: yourFirstNameSha256Variable,
        sha256_last_name: yourLastNameSha256Variable,
        sha256_street: yourStreetAddressSha256Variable,
        city: yourCityVariable,
        region: yourRegionVariable,
        postal_code: yourPostalCodeVariable,
        country: yourCountryVariable
      }
    }
  })
});

एक से ज़्यादा वैल्यू

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

Node.js

const measurementId = "MEASUREMENT_ID";
const apiSecret = "API_SECRET";

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    client_id: "CLIENT_ID",
    user_id: "USER_ID",
    events: [{
      name: "purchase"
    }],
    user_data: {
      sha256_email_address: [yourEmailSha256Variable1, yourEmailSha256Variable2],
      sha256_phone_number: [yourPhoneSha256Variable1, yourPhoneSha256Variable2],
      address: [{
        sha256_first_name: yourFirstNameSha256Variable1,
        sha256_last_name: yourLastNameSha256Variable1,
        sha256_street: yourStreetAddressSha256Variable1,
        city: yourCityVariable1,
        region: yourRegionVariable1,
        postal_code: yourPostalCodeVariable1,
        country: yourCountryVariable1
      },{
        sha256_first_name: yourFirstNameSha256Variable2,
        sha256_last_name: yourLastNameSha256Variable2,
        sha256_street: yourStreetAddressSha256Variable2,
        city: yourCityVariable2,
        region: yourRegionVariable2,
        postal_code: yourPostalCodeVariable2,
        country: yourCountryVariable2
      }]
    }
  })
});