ส่ง User-ID

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

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

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


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

ก่อนที่จะส่ง User-ID ได้ โปรดตรวจสอบว่าคุณได้ทำสิ่งต่อไปนี้แล้ว

ส่ง 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 ด้วย 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 อย่างถูกต้อง ตลอดเซสชันของผู้ใช้ ซึ่งจะแสดงสถานะการเข้าสู่ระบบปัจจุบันของผู้ใช้ แม้ว่า สถานะจะเปลี่ยนไปหลังจากโหลดหน้าเว็บแล้วก็ตาม

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