ส่งข้อมูลที่ได้จากผู้ใช้พร้อมกับ User-ID โดยใช้ Measurement Protocol

คุณใช้ Measurement Protocol ของ Google Analytics สำหรับ Google Analytics 4 เพื่อส่งข้อมูลที่ได้จากผู้ใช้พร้อมกับ User-ID ได้เช่นเดียวกับการใช้ gtag ซึ่งจะใช้เพื่อปรับปรุงพฤติกรรมและการวัด Conversion ได้

หากต้องการส่งข้อมูลที่ได้จากผู้ใช้พร้อมกับคำขอ Measurement Protocol ให้เพิ่มพารามิเตอร์ user_data ในเพย์โหลด JSON ต้องมีพารามิเตอร์ user_id ทุกครั้งที่ระบุ user_data

Measurement Protocol ใช้อัลกอริทึมการทำให้เป็นมาตรฐานและการแฮชเดียวกันกับฟีเจอร์การวัดที่ปรับปรุงแล้วของ Google Ads API สำหรับข้อกังวลเรื่องความเป็นส่วนตัว คุณจะต้องแฮชที่อยู่อีเมล หมายเลขโทรศัพท์ ชื่อ นามสกุล และที่อยู่โดยใช้อัลกอริทึม SHA-256 ก่อนที่จะอัปโหลด ค่าที่แฮชควรเข้ารหัสในรูปแบบสตริงฐาน 16 (ออบเจ็กต์สตริงที่มีเฉพาะเลขฐานสิบหก) เช่น 88d7ecb5c5b21d7b1

หากต้องการให้ผลลัพธ์แฮชเป็นมาตรฐาน คุณต��องทำสิ่งต่อไปนี้ก่อนแฮชค่าใดค่าหนึ่งต่อไปนี้

• นําช่องว่างขึ้นต้นและต่อท้ายออก
• แปลงข้อความให้เป็นตัวพิมพ์เล็ก
• จัดรูปแบบหมายเลขโทรศัพท์ตาม มาตรฐาน E164
• นำจุด (.) ที่อยู่ก่อนชื่อโดเมนในอีเมล gmail.com และ googlemail.com ทั้งหมดออก

เนื้อหาของโพสต์ JSON

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีจัดรูปแบบการรับส่งและเพย์โหลดในเอกสารอ้างอิง Measurement Protocol

ส่งข้อมูลที่ได้จากผู้ใช้

Measurement Protocol กำหนดให้นักพัฒนาซอฟต์แวร์ต้องแฮชข้อมูลที่ได้จากผู้ใช้ซึ่งมีความละเอียดอ่อนโดยใช้อัลกอริทึมการแฮชทางเดียวที่ปลอดภัยที่เรียกว่า SHA256 และเข้ารหัสข้อมูลดังกล่าวโดยใช้รูปแบบสตริงเลขฐาน 16 ก่อนเรียกใช้ API ซึ่งแตกต่างจาก gtag ซึ่งแฮชข้อมูลที่ละเอียดอ่อนที่ได้จากผู้ใช้โดยอัตโนมัติ

ช่องข้อมูลผู้ใช้ทุกช่องที่ขึ้นต้นด้วยคำนำหน้า sha256 ในชื่อควรป้อนข้อมูลด้วยค่าที่แฮชและเข้ารหัสฐาน 16 เท่านั้น

โค้ดตัวอย่างต่อไปนี้ทำตามขั้นตอนการเข้ารหัสและการเข้ารหัสที่จำเป็น

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

async function populateSensitiveUserData(value) {
  const encoder = new TextEncoder();
  // Convert a string value to UTF-8 encoded text.
  const value_utf8 = encoder.encode(value);
  // Compute the hash (digest) using the SHA-256 algorithm.
  const hash_sha256 = await subtle.digest('SHA-256', value_utf8);
  // Convert buffer to byte array.
  const hash_array = Array.from(new Uint8Array(hash_sha256));
  // Return a hex-encoded string.
  return hash_array.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 และส่งข้อมูลผู้ใช้พร้อมกับ User-ID

const measurement_id = 'G-XXXXXXXXXX';
const api_secret = '<secret_value>';

// 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=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    user_id: "XXX",
    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
      }
    }
  })
});

หลายค่า

นักพัฒนาแอปสามารถระบุค่าหลายค่า (ไม่เกิน 3 ค่าสำหรับโทรศัพท์และอีเมล และ 2 ค่าสำหรับที่อยู่) โดยใช้ค่าอาร์เรย์แทนการใช้สตริง หากคุณบันทึกมากกว่า 1 ค่า จะเพิ่มโอกาสในการจับคู่มากยิ่งขึ้น

const measurement_id = 'G-XXXXXXXXXX';
const api_secret = '<secret_value>';

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurement_id}&api_secret=${api_secret}`, {
  method: "POST",
  body: JSON.stringify({
    client_id: 'XXXXXXXXXX.YYYYYYYYYY',
    user_id: "XXX",
    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
      }]
    }
  })
});