Mã nhận dạng người dùng – SDK Android

Hướng dẫn cho nhà phát triển này minh hoạ cách triển khai Mã nhận dạng người dùng bằng cách sử dụng SDK Google Analytics dành cho Android phiên bản 3.x.

Tổng quan

Tính năng User ID cho phép đo lường hoạt động của người dùng trên nhiều thiết bị trong Google Analytics, chẳng hạn như phân bổ một lượt tương tác với một chiến dịch tiếp thị trên một thiết bị di động cho một lượt chuyển đổi xảy ra trên một thiết bị di động khác hoặc trong trình duyệt.

Khi User ID được gửi cùng với lượt truy cập Google Analytics thông qua trường userId, báo cáo của bạn sẽ phản ánh số lượng người dùng duy nhất chính xác hơn và cung cấp các tùy chọn báo cáo mới trên các thiết bị. Tìm hiểu thêm về các lợi ích khi sử dụng Mã nhận dạng người dùng.

Hướng dẫn này cho biết cách sử dụng trường userId và SDK Google Analytics dành cho Android để gửi mã nhận dạng người dùng đến Google Analytics.

Điều kiện tiên quyết

Trước khi gửi User ID đến Google Analytics:

Triển khai

Khi người dùng đã được ứng dụng Android của bạn biết đến, bạn nên gửi mã đại diện cho người dùng đó với tất cả các lượt truy cập Google Analytics của bạn, chẳng hạn như lượt xem trang, sự kiện, giao dịch thương mại điện tử, v.v. bằng cách sử dụng trường userId.

Để gửi Mã nhận dạng người dùng, hãy đặt trường userId bằng cách sử dụng ký hiệu và cú pháp trên Measurement Protocol và tên thông số Fields.USER_ID như trong ví dụ sau:

/**
 * An example method called when a user signs in to an authentication system.
 *
 * @param User user represents a generic User object returned by an authentication system on sign in.
 */
public void onUserSignIn(User user) {

  Tracker t = GoogleAnalytics.getInstance(context).getTracker("UA-XXXX-Y");

  // You only need to set User ID on a tracker once. By setting it on the tracker, the ID will be
  // sent with all subsequent hits.
  t.set(Fields.USER_ID, user.getId());

  // This hit will be sent with the User ID value and be visible in User-ID-enabled views (profiles).
  t.send(MapBuilder
      .createEvent("UX",       // Event category (required)
                   "Sign In",  // Event action (required)
                   null,       // Event label
                   null)       // Event value
      .build()
  );
}