ส่ง User-ID

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

ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์ User-ID ได้ที่วัดกิจกรรมในแพลตฟอร์มต่างๆ ดูวิธีตั้งค่า User-ID สำหรับแอปได้ที่ตั้งค่า User-ID

การตั้งค่ามิติข้อมูลที่กำหนดเองตามรหัสผู้ใช้จะทําให้มิติข้อมูลมีค่าที่ไม่ซ้ำกันมากเกินไป การมีค่าที่ไม่ซ้ำมากเกินไปจะทําให้เกิดปัญหากับข้อมูล Google Analytics และความแม่นยําในการรายงาน ดูข้อมูลเพิ่มเติมเกี่ยวกับแนวทางปฏิบัติแนะนำสำหรับ การตั้งค่า มิติข้อมูลที่กำหนดเอง


ก่อนเริ่มต้น

ก่อนที่จะส่งรหัสผู้ใช้ได้ โปรดตรวจสอบว่าคุณได้ทำสิ่งต่อไปนี้แล้ว

ส่ง User-ID

ค่าที่คุณส่งสำหรับ user_id จะขึ้นอยู่กับสถานะของผู้ใช้ ดังนี้

  • ผู้ใช้ไม่เคยลงชื่อเข้าใช้: อย่าส่งพารามิเตอร์ user_id
  • ผู้ใช้ลงชื่อเข้าใช้: ส่ง User-ID ของผู้ใช้
  • ผู้ใช้ลงชื่อเข้าใช้แล้วจึงออกจากระบบ: ส่ง null

หากต้องการส่ง User-ID ไปยัง Analytics ให้เพิ่มพารามิเตอร์ user_id ลงในคำสั่ง config ในแต่ละหน้าของเว็บไซต์

if (/* your logic for determining if the user is signed in */) {
  gtag('config', 'TAG_ID', {
    'user_id': 'USER_ID'
  });
} else if (/* your logic for determining if the user signed out */) {
  gtag('config', 'TAG_ID', {
    'user_id': null
  });
} else {
  // Do nothing if the user never signed in.
}
  1. แทนที่ TAG_ID ด้วยรหัสแท็ก
  2. แทนที่ความคิดเห็นด้วยการตรวจสอบว่าผู้ใช้ลงชื่อเข้าใช้หรือไม่ และ หากผู้ใช้ลงชื่อเข้าใช้แล้วแต่ออกจากระบบ
  3. หากผู้ใช้ลงชื่อเข้าใช้ ให้แทนที่ USER_ID ด้วยรหัสผู้ใช้ของตน
  4. เมื่อผู้ใช้ออกจากระบบ ให้ตั้งค่า user_id เป็น null อย่าส่งสตริงว่าง (""), สตริงเว้นวรรค (" ") หรือคำที่ยกมา "null" หรือ "NULL"

ตั้งค่า User-ID หลังจากการเริ่มต้น

ในหลายกรณี ระบบจะไม่ทราบ user_id เมื่อเริ่มต้นแท็ก Google เป็นครั้งแรก ตัวอย่างเช่น ผู้ใช้อาจเข้าชมเว็บไซต์ของคุณและลงชื่อเข้าใช้ในภายหลัง

หากต้องการตั้งค่าหรืออัปเดต user_id หลังจากโหลดหน้าเว็บครั้งแรก ให้ใช้คำสั่ง gtag('set') คำสั่งนี้จะตั้งค่า user_id สำหรับเหตุการณ์ต่อๆ ไปทั้งหมดในหน้าเว็บ และเป็นแนวทางที่แนะนำแทน gtag('config') ในสถานการณ์นี้

ตั้งค่า User-ID เมื่อเข้าสู่ระบบ

เมื่อผู้ใช้เข้าสู่ระบบสำเร็จ ให้เรียกใช้ gtag('set') เพื่อเชื่อมโยงรหัสของผู้ใช้กับเหตุการณ์ในอนาคต

// Example function called after successful login
function handleUserLogin(userId) {
  if (userId) {
    gtag('set', {'user_id': userId});
    console.log('User ID set for GA:', userId);

    // You can also send a login event
    gtag('event', 'login', { method: 'your_login_method' });
  }
}

// Example usage:
// handleUserLogin('12345_user');

ล้าง User-ID เมื่อออกจากระบบ

เมื่อผู้ใช้ออกจากระบบ คุณควรล้าง user_id โดยตั้งค่าเป็น null

// Example function called after logout
function handleUserLogout() {
  gtag('set', {'user_id': null});
  console.log('User ID cleared for GA.');

  // You can also send a logout event
  gtag('event', 'logout');
}

// Example usage:
// handleUserLogout();

การใช้ gtag('set') จะช่วยให้มั่นใจได้ว่า user_id ได้รับการจัดการอย่างถูกต้อง ตลอดเซสชันของผู้ใช้ ซึ่งจะแสดงสถานะการเข้าสู่ระบบปัจจุบันของผู้ใช้แม้ว่า สถานะจะเปลี่ยนไปหลังจากโหลดหน้าเว็บแล้วก็ตาม

ก่อนหน้า
เพิ่มพารามิเตอร์
ถัดไป
วัดข้อยกเว้น