Gửi mã nhận dạng người dùng

User-ID là giá trị nhận dạng riêng biệt của riêng bạn mà bạn chỉ định cho từng người dùng. Hướng dẫn này giải thích cách gửi mã nhận dạng người dùng đến Google Analytics, nhờ đó bạn có thể kết nối hành vi của người dùng trên nhiều phiên, thiết bị và nền tảng.

Để tìm hiểu thêm về tính năng User-ID, hãy xem bài viết Đo lường hoạt động trên nhiều nền tảng. Để tìm hiểu cách đặt mã nhận dạng người dùng cho một ứng dụng, hãy xem bài viết Đặt mã nhận dạng người dùng.

Việc đặt phương diện tuỳ chỉnh dựa trên mã nhận dạng người dùng sẽ dẫn đến các phương diện có quá nhiều giá trị riêng biệt. Việc có quá nhiều giá trị duy nhất sẽ gây ra vấn đề về dữ liệu và độ chính xác của báo cáo Google Analytics. Tìm hiểu thêm về các phương pháp hay nhất để thiết lập phương diện tuỳ chỉnh.


Trước khi bắt đầu

Trước khi có thể gửi mã nhận dạng người dùng, hãy đảm bảo bạn đã hoàn tất các bước sau:

Gửi mã nhận dạng người dùng

Giá trị mà bạn gửi cho user_id phụ thuộc vào trạng thái của người dùng:

  • Người dùng chưa bao giờ đăng nhập: Không gửi tham số user_id.
  • Người dùng đã đăng nhập: Gửi mã nhận dạng người dùng của họ.
  • Người dùng đã đăng nhập, sau đó đăng xuất: Gửi null.

Để gửi mã nhận dạng người dùng đến Analytics, hãy thêm thông số user_id vào lệnh config trên mỗi trang của trang web:

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. Thay thế TAG_ID bằng mã thẻ của bạn.
  2. Thay thế các nhận xét bằng các bước kiểm tra của bạn để xem người dùng có đăng nhập hay không và nếu người dùng đã đăng nhập nhưng sau đó đăng xuất.
  3. Nếu người dùng đã đăng nhập, hãy thay thế USER_ID bằng mã nhận dạng người dùng của họ.
  4. Khi người dùng đăng xuất, hãy đặt user_id thành null. Đừng gửi một chuỗi trống (""), một chuỗi trống (" ") hoặc các từ trong dấu ngoặc kép "null" hoặc "NULL".

Đặt mã nhận dạng người dùng sau khi khởi tạo

Trong nhiều trường hợp, user_id không được biết khi thẻ Google được khởi tạo lần đầu. Ví dụ: người dùng có thể truy cập vào trang web của bạn và chỉ đăng nhập sau đó.

Để đặt hoặc cập nhật user_id sau lần tải trang ban đầu, hãy sử dụng lệnh gtag('set'). Lệnh này đặt user_id cho tất cả các sự kiện tiếp theo trên trang và là phương pháp được đề xuất thay vì gtag('config') trong trường hợp này.

Đặt mã nhận dạng người dùng khi đăng nhập

Khi người dùng đăng nhập thành công, hãy gọi gtag('set') để liên kết mã nhận dạng của họ với các sự kiện trong tương lai:

// 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');

Xoá mã nhận dạng người dùng khi đăng xuất

Khi người dùng đăng xuất, bạn nên xoá user_id bằng cách đặt giá trị của tham số này thành 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();

Bằng cách sử dụng gtag('set'), bạn đảm bảo rằng user_id được quản lý đúng cách trong suốt phiên người dùng, phản ánh trạng thái đăng nhập hiện tại của người dùng ngay cả khi trạng thái này thay đổi sau khi trang đã tải.

Trước
Thêm thông số
Tiếp
Đo lường các trường hợp ngoại lệ