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.

Tham số user_id là một tham số cấu hình, không phải thuộc tính người dùng tuỳ chỉnh hoặc tham số sự kiện chuẩn. Thay vào đó, user_id là một thông số hệ thống dành riêng được dùng đặc biệt để xác định người dùng đã xác thực trên các thiết bị và phiên. Đừng đặt mã nhận dạng này làm thuộc tính người dùng tuỳ chỉnh (ví dụ: trong đối tượng user_properties cho gtag.js hoặc trong mục Thuộc tính người dùng của thẻ Trình quản lý thẻ của Google), đồng thời đừng đăng ký mã nhận dạng này làm phương diện tuỳ chỉnh trong giao diện người dùng Analytics. Tương tự, đừng truyền thông số này dưới dạng thông số ở cấp sự kiện cho các sự kiện riêng lẻ. Thay vào đó, hãy chỉ đặt user_id làm tham số cấu hình bằng cách sử dụng các phương thức sau.


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 chạy 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 user_id 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.

Cách User-ID được sử dụng trong Google Analytics

Sau khi bạn gửi giá trị user_id đến Google Analytics, giá trị này sẽ được dùng để:

  • Hợp nhất hành trình của người dùng: Kết nối hoạt động của người dùng trên nhiều phiên, thiết bị và nền tảng đối với người dùng đã đăng nhập.
  • Cải thiện số người dùng: Cung cấp các chỉ số chính xác hơn về người dùng và không bị trùng lặp.
  • Bật tính năng phân tích:
    • Phân tích hoạt động dựa trên trạng thái đăng nhập: Sử dụng các phương diện như "Đã đăng nhập bằng User ID" để tạo thông tin so sánh trong báo cáo chuẩn hoặc phân đoạn trong Dữ liệu khám phá.
    • Hỗ trợ kỹ thuật khám phá Trình khám phá người dùng, cho phép bạn xem chi tiết dòng thời gian hoạt động của từng người dùng.

Điểm quan trọng cần lưu ý

  • KHÔNG tạo phương diện tuỳ chỉnh cho User-ID: Bạn không nên đăng ký user_id làm phương diện tuỳ chỉnh ở phạm vi người dùng. Đây là một phương pháp hay quan trọng. Việc này sẽ tạo ra một phương diện có số lượng giá trị riêng biệt cao không cần thiết, có thể ảnh hưởng nghiêm trọng đến hiệu suất báo cáo, khiến dữ liệu được nhóm vào hàng "(other)" và tiêu tốn hạn mức phương diện tuỳ chỉnh của bạn. Tính năng User-ID tích hợp sẽ xử lý việc liên kết người dùng. Tìm hiểu thêm trong bài viết Các phương pháp hay nhất về User-ID.

  • Đặt user_id làm chế độ cài đặt cấu hình, chứ không phải thuộc tính người dùng hoặc thông số sự kiện: Vì user_id là một thông số hệ thống được đặt trước, nên bạn chỉ được áp dụng thông số này làm cấu hình hoặc thông số cài đặt (bằng cách sử dụng các lệnh gtag() config hoặc set, hoặc chế độ cài đặt cấu hình thẻ Google của Trình quản lý thẻ của Google). Đừng định cấu hình mã này dưới dạng thuộc tính người dùng tuỳ chỉnh, hãy truyền mã này vào bên trong đối tượng user_propertiessettings hoặc gửi mã này dưới dạng thông số ở cấp sự kiện trên các sự kiện riêng lẻ.

  • Khả năng hiển thị trực tiếp mã nhận dạng trong báo cáo chuẩn so với dữ liệu khám phá: Giá trị user_id thô không có sẵn dưới dạng phương diện chuẩn trong báo cáo chuẩn hoặc hầu hết dữ liệu khám phá (chẳng hạn như Dữ liệu tuỳ chỉnh) để duy trì quyền riêng tư và quản lý số lượng giá trị riêng biệt. Tuy nhiên, bạn có thể xem user_id thô trong mẫu khám phá Trình khám phá người dùng trong cột có nhãn Mã nhận dạng người dùng thực tế cho người dùng đã đăng nhập.

  • Truy cập vào mã nhận dạng người dùng thô: Nếu cần phân tích bằng các giá trị user_id thô, bạn nên sử dụng tính năng Google Analytics 4 BigQuery Export. Trường user_id có trong dữ liệu đã xuất.

Để đảm bảo dữ liệu User-ID đang được sử dụng và xuất hiện trong Trình khám phá người dùng, hãy đảm bảo Thông tin nhận dạng trong báo cáo của tài sản được đặt thành Kết hợp hoặc Được quan sát.

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