মেজারমেন্ট প্রোটোকল ব্যবহার করে ব্যবহারকারীর দেওয়া ডেটা পাঠানো

gtag ব্যবহার করার মতোই, আপনি Google Analytics Measurement Protocol ব্যবহার করে ব্যবহারকারীর আইডি সহ ব্যবহারকারীর দেওয়া ডেটা পাঠাতে পারবেন, যা ব্যবহারকারীর আচরণ ও কনভার্সন ট্র্যাক করার সুবিধা উন্নত করতে ব্যবহার করা যেতে পারে।

Measurement Protocol অনুরোধের সাথে ব্যবহারকারীর প্রদান করা ডেটা পাঠাতে, JSON পেলোডে user_data প্যারামিটার যোগ করুন। আমরা সাজেস্ট করি যে user_data প্রদান করা হলে আপনি যেন user_id প্যারামিটারও অন্তর্ভুক্ত করেন। এটি সবচেয়ে নির্ভুল পরিমাপ ও ফিচার কার্যকারিতা নিশ্চিত করতে সাহায্য করে।

Measurement Protocol, Data Manager API এবং Google Ads enhanced conversions-এর মতো একই নরমালাইজেশন ও হ্যাশিং সংক্রান্ত নিয়ম ব্যবহার করে। গোপনীয়তা সংক্রান্ত উদ্বেগের কারণে, ইমেল আইডি, ফোন নম্বর, নাম, পদবি এবং রাস্তার ঠিকানা আপলোড করার আগে 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 স্ট্যান্ডার্ড অনুযায়ী ফর্ম্যাট করা।

ট্রান্সপোর্ট ও পেলোড কীভাবে ফর্ম্যাট করা হয় সেই সম্পর্কে আরও তথ্য পেতে Measurement Protocol রেফারেন্স ডকুমেন্টেশন দেখুন।

ব্যবহারকারীর দেওয়া ডেটা পাঠান

gtag-এর মতো নয়, যা ব্যবহারকারীর দেওয়া সংবেদনশীল ডেটা অটোমেটিক হ্যাশ করে, Measurement Protocol-এর ক্ষেত্রে একজন ডেভেলপারকে ব্যবহারকারীর দেওয়া সংবেদনশীল ডেটা হ্যাশ করতে হয়, এর জন্য SHA256 নামে একটি নিরাপদ ওয়ান-ওয়ে হ্যাশিং অ্যালগরিদম ব্যবহার করা হয় এবং API কল করার আগে হেক্স স্ট্রিং ফর্ম্যাট ব্যবহার করে এটি এনকোড করা হয়।

ব্যবহারকারীর ডেটার যেসব ফিল্ডের নাম 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) অ্যারের পরিবর্তে সিঙ্গুলার ভ্যালু পাস করা যেতে পারে।

নিম্নলিখিত স্যাম্পেল কোড Measurement Protocol কল করে এবং ব্যবহারকারীর আইডির সাথে ব্যবহারকারীর ডেটা পাস করে।

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
      }]
    }
  })
});