Phương diện và số liệu tùy chỉnh

Hướng dẫn cho nhà phát triển này mô tả cách sử dụng Google Analytics SDK phiên bản 4 dành cho Android để triển khai các phương diện và chỉ số tuỳ chỉnh.

Tổng quan

Bạn có thể:

Thứ nguyên và chỉ số tùy chỉnh bao gồm hai trường:

Tên trường Loại Nội dung mô tả
Chỉ mục Integer Chỉ mục của phương diện hoặc chỉ số tuỳ chỉnh. Chỉ mục này dựa trên 1.
Giá trị String Giá trị của phương diện hoặc chỉ số tuỳ chỉnh. Trong trường hợp này, chỉ số sẽ được phân tích cú pháp dưới dạng số nguyên hoặc giá trị thập phân dạng điểm cố định nếu chỉ số được định cấu hình thành một loại đơn vị tiền tệ.

Cài đặt và gửi giá trị

Cách đặt và gửi một giá trị phương diện tuỳ chỉnh:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomDimension(1, "premiumUser")
    .build()
);

Bạn có thể gửi giá trị thứ nguyên tùy chỉnh cùng với bất kỳ loại lượt truy cập Google Analytics nào, bao gồm lượt xem màn hình, sự kiện, giao dịch thương mại điện tử, thời gian người dùng và tương tác trên mạng xã hội. Phạm vi đã xác định của thứ nguyên tùy chỉnh sẽ xác định lượt truy cập được liên kết với giá trị thứ nguyên tại thời điểm xử lý.

Cách đặt và gửi một giá trị chỉ số tuỳ chỉnh:

// Get tracker.
Tracker t = ((AnalyticsSampleApp) getActivity().getApplication()).getTracker(
    TrackerName.APP_TRACKER);
t.setScreenName("Home Screen");

// Send the custom dimension value with a screen view.
// Note that the value only needs to be sent once.
t.send(new HitBuilders.ScreenViewBuilder()
    .setCustomMetric(1, 5)
    .build()
);

Xem phần Cấu hình nâng cao để biết thông tin chi tiết về phương thức getTracker.

Cân nhắc khi triển khai

Phần này trình bày các yếu tố khác cần cân nhắc khi triển khai phương diện hoặc chỉ số tuỳ chỉnh.

Những điểm cần lưu ý về phương diện tuỳ chỉnh

Giá trị có phạm vi cấp người dùng và cấp phiên hoạt động áp dụng cho lượt truy cập trước đây

  • Giá trị thứ nguyên tùy chỉnh có phạm vi cấp người dùng hoặc cấp phiên hoạt động sẽ áp dụng cho tất cả các lượt truy cập trong phiên hoạt động hiện tại, bao gồm cả lượt truy cập trước đây. Nếu bạn không muốn áp dụng giá trị thứ nguyên tùy chỉnh có phạm vi cấp phiên hoạt động hoặc cấp người dùng cho lượt truy cập trước đây trong phiên hiện tại, hãy bắt đầu một phiên mới trước khi áp dụng giá trị cho một lượt truy cập.
  • Ví dụ: nếu bạn đang sử dụng loại thành viên làm phương diện tuỳ chỉnh cấp người dùng và một người dùng nâng cấp tư cách thành viên của họ vào giữa phiên, thì bạn nên bắt đầu một phiên hoạt động mới trước khi đặt giá trị phương diện tuỳ chỉnh mới. Điều này đảm bảo rằng các lượt truy cập trước khi nâng cấp sẽ được liên kết với giá trị thành viên cũ, trong khi các lượt truy cập mới sẽ được liên kết với giá trị mới.

Phương diện tùy chỉnh và bộ lọc chế độ xem (Hồ sơ)

  • Giá trị thứ nguyên tùy chỉnh cấp người dùng hoặc cấp phiên sẽ vẫn được áp dụng cho tất cả các lượt truy cập trong phiên hiện tại và/hoặc trong tương lai ngay cả khi lượt truy cập mà chúng được gửi cùng bị lọc khỏi chế độ xem (hồ sơ) .
  • Khi lọc một giá trị thứ nguyên tùy chỉnh, lượt truy cập được lọc theo phạm vi của giá trị thứ nguyên tùy chỉnh đó. Tìm hiểu thêm về cách các bộ lọc và giá trị phương diện tuỳ chỉnh tương tác khi dữ liệu của bạn được xử lý.

Những điểm cần lưu ý về chỉ số tuỳ chỉnh

Các giá trị chỉ số tùy chỉnh được tổng hợp trong báo cáo

  • Giá trị chỉ số tùy chỉnh được tổng hợp trong báo cáo giống như các chỉ số được xác định trước khác trong Google Analytics. Do đó, bạn sẽ đặt giá trị chỉ số tuỳ chỉnh là 1 để làm tăng tổng giá trị tổng hợp của chỉ số đó trong báo cáo.

Chỉ số tùy chỉnh và bộ lọc chế độ xem (Hồ sơ)

  • Mặc dù các giá trị chỉ số tùy chỉnh thường có thể được đặt bất cứ khi nào thuận tiện, nhưng bạn nên tránh đặt giá trị chỉ số tùy chỉnh trên những lượt truy cập có thể bị lọc bỏ khỏi chế độ xem (hồ sơ) của bạn. Nếu một lượt truy cập được lọc bằng bộ lọc chế độ xem (hồ sơ), thì mọi giá trị chỉ số tùy chỉnh được liên kết cũng sẽ được lọc. Tìm hiểu thêm về phương diện và chỉ số tuỳ chỉnh cũng như bộ lọc chế độ xem (hồ sơ).

Đặt giá trị bằng tính năng tự động đo lường màn hình

  • Để áp dụng giá trị thứ nguyên tùy chỉnh cho lượt xem màn hình được gửi thông qua tính năng tự động đo lường màn hình, hãy đặt giá trị trước khi activityStart() được gọi trong onStart(). Xin lưu ý rằng trong trường hợp giá trị không được xác định tại thời điểm onStart() thực thi, bạn nên đo lường màn hình theo cách thủ công.

Không gửi thông tin nhận dạng cá nhân (PII) làm giá trị