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ể:
- Sử dụng giao diện web của Google Analytics để định cấu hình thứ nguyên hoặc chỉ số tùy chỉnh. Tìm hiểu cách thiết lập một phương diện hoặc chỉ số tuỳ chỉnh (Trung tâm trợ giúp).
- Đặt và gửi giá trị thứ nguyên và chỉ số tùy chỉnh từ một ứng dụng.
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 trongonStart()
. Xin lưu ý rằng trong trường hợp giá trị không được xác định tại thời điểmonStart()
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ị
- Điều khoản dịch vụ của Google Analytics nghiêm cấm gửi bất kỳ thông tin nhận dạng cá nhân (PII) nào đến các máy chủ của Google Analytics. Để biết thêm thông tin, vui lòng tham khảo Điều khoản dịch vụ.