Phương diện và chỉ số tuỳ chỉnh – SDK Android phiên bản 2 (Cũ)

Hướng dẫn cho nhà phát triển này mô tả cách triển khai thứ nguyên và chỉ số tùy chỉnh bằng cách sử dụng SDK Google Analytics dành cho Android phiên bản 2.

Tổng quan

Khi bạn đặt một giá trị thứ nguyên hoặc chỉ số tùy chỉnh bằng cách sử dụng SDK Google Analytics dành cho Android , giá trị đó sẽ được gửi dưới dạng thông số cùng với lượt truy cập tiếp theo được gửi đi. Các giá trị đó có thể được áp dụng cho bất kỳ loại lượt truy cập Google Analytics nào, bao gồm cả 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.

Có hai bước chính để triển khai một chỉ số hoặc phương diện tuỳ chỉnh:

  1. Xác định phương diện hoặc chỉ số tuỳ chỉnh bằng cách sử dụng giao diện web của Google Analytics.
    Đặt chỉ mục, tên và phạm vi của thứ nguyên hoặc chỉ số tùy chỉnh trong phần cài đặt thuộc tính của giao diện web.
    Tìm hiểu cách xác định phương diện hoặc chỉ số tuỳ chỉnh.
  2. Triển khai mã để đặt và thu thập các giá trị phương diện và chỉ số tuỳ chỉnh.
    Thêm mã vào ứng dụng của bạn để đặt giá trị thứ nguyên hoặc chỉ số tùy chỉnh cho lượt truy cập Google Analytics tại các chỉ mục mà bạn đã xác định trong bước trước.

Phần còn lại của bài viết này sẽ mô tả cách triển khai mã để đặt và gửi giá trị thứ nguyên hoặc chỉ số tùy chỉnh đến Google Analytics.

Phương diện tuỳ chỉnh

Bạn có thể đặt giá trị thứ nguyên tùy chỉnh trên tất cả các loại lượt truy cập Google Analytics. Hãy đặt một giá trị thứ nguyên tùy chỉnh ngay trước lệnh gọi gửi mà bạn muốn áp dụng giá trị đó.

Phạm vi đã xác định của thứ nguyên tùy chỉnh sẽ xác định thời điểm xử lý những lượt truy cập bổ sung có thể được liên kết với giá trị đó.

Bạn bắt buộc phải sử dụng các trường sau để đặt giá trị phương diện tuỳ chỉnh:

  • Integer Chỉ mục – chỉ mục của định nghĩa phương diện tuỳ chỉnh. Chỉ mục này dựa trên 1.
  • String Giá trị – giá trị của phương diện tuỳ chỉnh.

Đặt giá trị phương diện tùy chỉnh

Để đặt giá trị thứ nguyên tùy chỉnh, hãy gọi setCustomDimension trước lệnh gọi gửi mà bạn muốn liên kết giá trị:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Set the dimension value for index 1.
tracker.setCustomDimension(1, "myValue");

// Dimension value is associated and sent with this hit.
tracker.sendView();

Cân nhắc khi triển khai

Phần này trình bày các điểm cần cân nhắc khác cần lưu ý khi triển khai phương diện tuỳ chỉnh.

Phạm vi cấp người dùng và phiên đang tham gia

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 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 các 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 hoạt động, thì bạn nên bắt đầu một phiên hoạt động mới trước khi đặt giá trị thứ nguyê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 hoạt động vẫn sẽ đượ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 được gửi cùng bị lọc khỏi một 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ị thứ nguyên tùy chỉnh tương tác khi dữ liệu của bạn được xử lý.

Đặ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 đo lường màn hình tự động của EasyTracker, 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 xác định tại thời điểm onStart() thực thi, bạn nên sử dụng phương pháp đ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ụ.

Chỉ số tuỳ chỉnh

Mặc dù bạn cần áp dụng cẩn thận thứ nguyên tùy chỉnh cho các lượt truy cập cụ thể và quản lý theo phạm vi, nhưng lượt truy cập được áp dụng chỉ số tùy chỉnh thường sẽ không ảnh hưởng đến báo cáo. Do đó, bạn có thể đặt thứ nguyên này bất cứ khi nào giá trị chỉ số được biết.

Bạn bắt buộc phải sử dụng các trường sau đây để đặt giá trị chỉ số tuỳ chỉnh:

  • Integer Chỉ mục – chỉ mục của định nghĩa chỉ số tùy chỉnh.
  • Integer Giá trị – giá trị của chỉ số tuỳ chỉnh. Các giá trị có thể là số âm.

Đặt giá trị chỉ số tùy chỉnh

Để đặt giá trị chỉ số tuỳ chỉnh, hãy gọi setCustomMetric trước một lệnh gọi gửi khác:

// Get the tracker object.
Tracker tracker = EasyTracker.getTracker();

// Increment the metric at index 1.
tracker.setCustomMetric(1, 1);

// Metric value sent with this hit.
tracker.sendView();

Hoặc cách đặt chỉ số tùy chỉnh đơn vị tiền tệ:

// Get the tracker.
Tracker tracker = EasyTracker.getTracker();

// Create a map for hit params.
HashMap params = new HashMap();
params.put(ModelFields.APP_SCREEN, "Product Page");

// Set currency value to custom metric slot 1.
// Currency values may be fixed decimal.
params.put("&cm1", "24.99");

// Send the custom metric value with a screen view.
tracker.send("appview", params);

Cân nhắc khi triển khai

Phần sau đây trình bày các điểm cần cân nhắc khác cần lưu ý khi lập kế hoạch triển khai thứ nguyên hoặc chỉ số tùy 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 các 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 các 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 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ơ).