Các phương diện và chỉ số được hỗ trợ trong truy vấn đến phương thức Theo thời gian thực của API Dữ liệu Analytics. Các phương thức Báo cáo chính (ví dụ: RunReport`) chấp nhận một tập hợp Phương diện và chỉ số khác với phương thức Theo thời gian thực.
Kích thước
Bạn có thể yêu cầu các phương diện sau trong báo cáo cho bất kỳ tài sản nào. Chỉ định "Tên API" trong trường name của tài nguyên Dimension cho cột của phương diện trong phản hồi báo cáo.
| Tên API | Tên giao diện người dùng | Mô tả |
|---|---|---|
appVersion |
Phiên bản ứng dụng | Tên phiên bản của ứng dụng (Android) hoặc phiên bản của gói dạng ngắn (iOS). |
audienceId |
ID đối tượng | Giá trị nhận dạng dạng số của một Đối tượng. Người dùng được báo cáo trong các đối tượng mà họ thuộc về trong phạm vi ngày của báo cáo. Hành vi hiện tại của người dùng không ảnh hưởng đến tư cách thành viên trước đây của đối tượng trong báo cáo. |
audienceName |
Tên đối tượng | Tên của một Đối tượng. Người dùng được báo cáo trong các đối tượng chứa họ trong phạm vi ngày của báo cáo. Hành vi hiện tại của người dùng không ảnh hưởng đến tư cách thành viên trước đây của đối tượng trong báo cáo. |
audienceResourceName |
Tên tài nguyên cho đối tượng | Tên tài nguyên của đối tượng này. Tên tài nguyên chứa cả giá trị nhận dạng tài nguyên và tập hợp để xác định duy nhất một tài nguyên; để tìm hiểu thêm, hãy xem phần Tên tài nguyên. |
city |
Thành phố | Thành phố bắt nguồn hoạt động của người dùng. |
cityId |
Mã thành phố | Mã địa lý của thành phố nơi bắt nguồn hoạt động của người dùng, được lấy từ địa chỉ IP của họ. |
country |
Quốc gia | Quốc gia nơi bắt nguồn hoạt động của người dùng. |
countryId |
Mã quốc gia | Mã địa lý của quốc gia nơi bắt nguồn hoạt động của người dùng, được lấy từ địa chỉ IP của họ. Được định dạng theo tiêu chuẩn ISO 3166-1 alpha-2. |
deviceCategory |
Danh mục thiết bị | Loại thiết bị: Máy tính để bàn, Máy tính bảng hoặc Điện thoại di động. |
eventName |
Tên sự kiện | Tên của sự kiện. |
minutesAgo |
Phút trước theo thời gian thực | Số phút trước khi một sự kiện được thu thập. 00 là phút hiện tại và 01 có nghĩa là phút trước đó. |
platform |
Nền tảng | Nền tảng mà ứng dụng hoặc trang web của bạn đã chạy; ví dụ: web, iOS hoặc Android. Để xác định loại luồng trong báo cáo, hãy sử dụng cả nền tảng và streamId. |
streamId |
Mã luồng | Giá trị nhận dạng luồng dữ liệu dạng số cho ứng dụng hoặc trang web của bạn. |
streamName |
Tên luồng | Tên luồng dữ liệu cho ứng dụng hoặc trang web của bạn. |
unifiedScreenName |
Tiêu đề trang và tên màn hình | Tiêu đề trang (web) hoặc tên màn hình (ứng dụng) nơi sự kiện được ghi lại. |
Phương diện tùy chỉnh
API Dữ liệu theo thời gian thực có thể tạo báo cáo về Phương diện tuỳ chỉnh ở phạm vi người dùng. Hãy xem bài viết Thuộc tính người dùng tuỳ chỉnh để tìm hiểu thêm về phương diện tuỳ chỉnh. Phương diện tuỳ chỉnh được chỉ định trong yêu cầu báo cáo API theo tên và phạm vi tham số của phương diện. Ví dụ: đưa "customUser:last_level" vào yêu cầu Data API để tạo một báo cáo cho Phương diện tuỳ chỉnh ở phạm vi người dùng với tên thông số là "last_level". Yêu cầu API này sẽ không thành công nếu tài sản chưa đăng ký Phương diện tuỳ chỉnh ở phạm vi người dùng này.
Sau đây là cú pháp chung cho Phương diện tuỳ chỉnh. Bạn có thể truy vấn phương thức API siêu dữ liệu để liệt kê tất cả Phương diện tuỳ chỉnh cho một Tài sản.
| Tên API chung | Mô tả |
|---|---|
| customUser:parameter_name | Phương diện tuỳ chỉnh ở phạm vi người dùng cho parameter_name |
API thời gian thực không hỗ trợ phương diện tuỳ chỉnh ở phạm vi sự kiện.
Chỉ số
Bạn có thể yêu cầu các chỉ số sau trong báo cáo cho bất kỳ tài sản nào. Chỉ định "Tên API" trong trường name của tài nguyên Metric cho cột của chỉ số trong phản hồi báo cáo.
| Tên API | Tên giao diện người dùng | Mô tả |
|---|---|---|
activeUsers |
Số người dùng đang hoạt động | Số người dùng riêng biệt đã truy cập vào trang web hoặc ứng dụng của bạn. |
eventCount |
Số sự kiện | Số sự kiện. |
keyEvents |
Sự kiện chính | Số lượng sự kiện chính. Việc đánh dấu một sự kiện là sự kiện chính sẽ ảnh hưởng đến các báo cáo kể từ thời điểm tạo. Việc này không làm thay đổi dữ liệu trong quá khứ. Bạn có thể đánh dấu bất kỳ sự kiện nào là sự kiện chính trong Google Analytics. Theo mặc định, một số sự kiện (chẳng hạn như first_open hoặc purchase) sẽ được đánh dấu là sự kiện chính. |
screenPageViews |
Số lượt xem | Số màn hình ứng dụng hoặc số trang trong trang web mà người dùng đã xem. Chỉ số này tính cả số lượt xem lặp lại của một trang hoặc màn hình. (số sự kiện screen_view + số sự kiện page_view). |
Chỉ số tuỳ chỉnh ở phạm vi sự kiện không được hỗ trợ trong API theo thời gian thực.