ส่ง User-ID

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

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

พารามิเตอร์ user_id เป็นพารามิเตอร์การกำหนดค่า ไม่ใช่พร็อพเพอร์ตี้ผู้ใช้ที่กำหนดเองหรือพารามิเตอร์เหตุการณ์มาตรฐาน แต่ user_id เป็นพารามิเตอร์ระบบที่สงวนไว้ซึ่งใช้เพื่อระบุผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ในอุปกรณ์และเซสชันต่างๆ โดยเฉพาะ อย่าตั้งค่าเป็นพร็อพเพอร์ตี้ผู้ใช้ที่กำหนดเอง (เช่น ในออบเจ็กต์ user_properties สำหรับ gtag.js หรือในส่วนพร็อพเพอร์ตี้ผู้ใช้ ของแท็ก Google Tag Manager) และอย่าลงทะเบียนเป็นมิติข้อมูลที่กำหนดเองใน UI ของ Analytics นอกจากนี้ อย่าส่งเป็นพารามิเตอร์ระดับเหตุการณ์ในเหตุการณ์แต่ละรายการ แต่ให้ตั้งค่า user_id เป็นพารามิเตอร์การกำหนดค่าเท่านั้นโดยใช้วิธีต่อไปนี้


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

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

วิธีใช้ User-ID ใน Google Analytics

เมื่อคุณส่งค่า user_id ไปยัง Google Analytics ระบบจะใช้ค่าดังกล่าวเพื่อดำเนินการต่อไปนี้

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

สิ่งสำคัญที่ต้องคำนึงถึง

  • อย่าสร้างมิติข้อมูลที่กำหนดเองสำหรับ User-ID: คุณไม่ควร ลงทะเบียน user_id เป็นมิติข้อมูลที่กำหนดเองระดับผู้ใช้ ซึ่งเป็นแนวทางปฏิบัติแนะนำที่สำคัญ การดำเนินการดังกล่าวจะสร้างมิติข้อมูล High Cardinality ที่ไม่จำเป็น ซึ่งอาจส่งผลเสียอย่างมากต่อประสิทธิภาพของรายงาน ทำให้ข้อมูลถูกจัดกลุ่มไว้ในแถว "(อื่นๆ)" และใช้โควต้าของมิติข้อมูลที่กำหนดเอง ฟีเจอร์ User-ID ในตัวจะจัดการการรวมผู้ใช้ ดูข้อมูลเพิ่มเติมได้ที่ แนวทางปฏิบัติแนะนำสำหรับ User-ID

  • ตั้งค่า user_id เป็นการตั้งค่าการกำหนดค่า ไม่ใช่พร็อพเพอร์ตี้ผู้ใช้หรือพารามิเตอร์เหตุการณ์:เนื่องจาก user_id เป็นพารามิเตอร์ระบบที่สงวนไว้ คุณจึงต้องใช้เป็นการกำหนดค่าหรือพารามิเตอร์การตั้งค่าเท่านั้น (โดยใช้คำสั่ง gtag() config หรือ set หรือการตั้งค่าการกำหนดค่าแท็ก Google ของ Google Tag Manager) อย่ากำหนดค่าเป็นพร็อพเพอร์ตี้ผู้ใช้ที่กำหนดเอง ส่งภายในออบเจ็กต์การตั้งค่า user_properties หรือส่งเป็นพารามิเตอร์ระดับเหตุการณ์ในเหตุการณ์แต่ละรายการ

  • การแสดงผลรหัสโดยตรงในรายงานมาตรฐานเทียบกับการสำรวจ: ระบบจะไม่แสดงค่า user_id ดิบเป็นมิติข้อมูลมาตรฐานในรายงานมาตรฐานหรือการสำรวจส่วนใหญ่ (เช่น การสำรวจรูปแบบอิสระ) เพื่อรักษาความเป็นส่วนตัวและจัดการ Cardinality อย่างไรก็ตาม คุณสามารถดู user_id ดิบได้ในเทมเพลตการสำรวจโปรแกรมสำรวจผู้ใช้ ในคอลัมน์ที่มีป้ายกำกับว่าUser-ID ที่มีผล สำหรับผู้ใช้ที่เข้าสู่ระบบ

  • การเข้าถึง User-ID ดิบ: หากต้องการทำการวิเคราะห์โดยใช้ค่า ดิบ user_id วิธีที่แนะนำคือใช้ Google Analytics 4 BigQuery Export ช่อง user_id จะอยู่ในข้อมูลที่ส่งออก

หากต้องการให้แน่ใจว่าระบบใช้ข้อมูล User-ID และแสดงข้อมูลดังกล่าวในโปรแกรมสำรวจผู้ใช้ ให้ ตรวจสอบว่าข้อมูลระบุตัวตนในการรายงานของพร็อพเพอร์ตี้ตั้งค่าเป็นรวม หรือสังเกต

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