Những phương diện và chỉ số được hỗ trợ trong truy vấn đối với Phương thức theo thời gian thực của Analytics Data API. Phương thức Báo cáo chính (ví dụ: RunReport`) chấp nhận 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 mọi tài sản. Chỉ định "Tên API" trong trường name của tài nguyên Dimension cho một 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 | Nội dung 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 | Mã đối tượng | Giá trị nhận dạng bằng số của Đối tượng. Người dùng được báo cáo trong đố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. |
| 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 đố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. |
| thành phố | 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 hoạt động của người dùng bắt nguồn từ địa chỉ IP của người dùng. |
| 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 hoạt động của người dùng bắt nguồn, bắt nguồn từ địa chỉ IP của người dùng. Đượ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 Thiết bị 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 mà 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) mà sự kiện được ghi lại. |
Phương diện tuỳ 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 trong phạm vi người dùng. 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 của thông số. Ví dụ: đưa "customUser:last_level" vào yêu cầu API dữ liệu để tạo báo cáo cho Phương diện tuỳ chỉnh trong phạm vi người dùng có 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 trong 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ả các Phương diện tùy chỉnh cho một thuộc tính.
| Tên API chung | Nội dung mô tả |
|---|---|
| customUser:parameter_name | Phương diện tùy chỉnh trong phạm vi người dùng cho parameter_name |
API thời gian thực không hỗ trợ các 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 đây trong báo cáo cho mọi tài sản. Chỉ định "Tên API" trong trường name của tài nguyên Metric cho một 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 | Nội dung 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. |
| số lượt chuyển đổi | Lượt chuyển đổi | Số sự kiện chuyển đổi. Các sự kiện được đánh dấu là lượt chuyển đổi tại thời điểm thu thập. Những thay đổi đối với cách đánh dấu lượt chuyển đổi của một sự kiện sẽ áp dụng từ thời điểm thay đổi trở đi. Bạn có thể đánh dấu bất kỳ sự kiện nào là lượt chuyển đổi trong Google Analytics và một số sự kiện (ví dụ: first_open, purchase) được đánh dấu là lượt chuyển đổi theo mặc định. Để tìm hiểu thêm, hãy xem bài viết Giới thiệu về lượt chuyển đổi. |
| eventCount | Số sự kiện | Số lượng sự kiện. |
| 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ự kiện screen_view + sự kiện page_view). |
API thời gian thực không hỗ trợ chỉ số tuỳ chỉnh ở phạm vi sự kiện.