Những phương diện và chỉ số được hỗ trợ trong truy vấn đối với phương thức Báo cáo quyền truy cập vào dữ liệu của API Quản trị Analytics.
Kích thước
Bạn có thể yêu cầu các phương diện sau trong báo cáo quyền truy cập dữ liệu. Chỉ định "Tên API" trong trường phương diện name của tài nguyên AccessDimension 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 | Các thuộc tính được phép | Nội dung mô tả |
|---|---|---|---|
| accessDateHour | Giờ truy cập | Tất cả tài sản Google Analytics | Ngày giờ mà người dùng GA đã truy cập vào dữ liệu báo cáo GA. Được định dạng dưới dạng YYYYMMDDHH. |
| accessMechanism | Cơ chế truy cập | Tài sản Google Analytics 360 | Cơ chế mà thông qua đó người dùng GA đã truy cập vào dữ liệu báo cáo GA. Các giá trị có thể bao gồm Google Analytics User Interface, Google Analytics API, Firebase, Google Ads và các giá trị khác. |
| accessedPropertyId | Mã tài sản đã truy cập | Tất cả tài sản Google Analytics | Mã tài sản mà bạn đã truy cập vào dữ liệu báo cáo GA. Hầu hết Báo cáo quyền truy cập dữ liệu chỉ chứa một tài sản, nhưng nếu tài sản được yêu cầu có tài sản phụ, thì Báo cáo truy cập dữ liệu sẽ chứa quyền truy cập vào cả tài sản nguồn và tài sản phụ. Để tìm hiểu thêm về tài sản phụ, hãy xem bài viết Giới thiệu về tài sản phụ |
| accessedPropertyName | Tên thuộc tính được truy cập | Tất cả tài sản Google Analytics | Tên hiển thị của tài sản mà bạn muốn truy cập vào dữ liệu báo cáo GA. Hầu hết Báo cáo quyền truy cập dữ liệu chỉ chứa một tài sản, nhưng nếu tài sản được yêu cầu có tài sản phụ, thì Báo cáo truy cập dữ liệu sẽ chứa quyền truy cập vào cả tài sản nguồn và tài sản phụ. Để tìm hiểu thêm về tài sản phụ, hãy xem bài viết Giới thiệu về tài sản phụ |
| accessorAppName | Tên ứng dụng trình truy cập | Tất cả tài sản Google Analytics | Tên của ứng dụng đã truy cập vào dữ liệu báo cáo của Google Analytics. |
| costDataReturned | Dữ liệu chi phí trả về | Tài sản Google Analytics 360 | Trả về true nếu dữ liệu chi phí được trả về trong báo cáo này. Nếu không, phương diện này sẽ trả về false. Người dùng GA có quy định hạn chế về No Cost Metrics không thể xem các chỉ số về chi phí. Phương diện này sẽ luôn là false trong khi quy định hạn chế đó có hiệu lực. Để tìm hiểu thêm, hãy xem bài viết Quản lý quyền truy cập và quy định hạn chế về dữ liệu. |
| dataApiQuotaCategory | Danh mục hạn mức API dữ liệu | Tất cả tài sản Google Analytics | Danh mục hạn mức cho yêu cầu Data API. Các giá trị có thể bao gồm: Core, Realtime và Funnel. |
| epochTimeMicros | Phần triệu thời gian bắt đầu của hệ thống (Epoch) | Tài sản Google Analytics 360 | Unix micrô giây kể từ khoảng thời gian bắt đầu của hệ thống mà người dùng GA truy cập vào dữ liệu báo cáo GA. Ví dụ: một micrô giây unix của 1655220215027371 là 2022-06-14 11:23:35 ở Mỹ/New_Israel. |
| mostRecentAccessEpochTimeMicros | Phần triệu thời gian bắt đầu của hệ thống truy cập gần đây nhất | Tài sản Google Analytics 360 | Dấu thời gian truy cập gần đây nhất cho hàng này. Được trả về tính bằng unix micrô giây kể từ thời gian bắt đầu của hệ thống. Thường được dùng với userEmail và các phương diện tương tự để xác định lần truy cập gần đây nhất của người dùng GA. |
| reportType | Loại báo cáo | Tài sản Google Analytics 360 | Loại dữ liệu báo cáo mà người dùng GA đã truy cập. Các giá trị có thể bao gồm Reporting, Realtime, Free form exploration, Funnel exploration và các giá trị khác. |
| revenueDataReturned | Đã trả về dữ liệu doanh thu | Tài sản Google Analytics 360 | Trả về true nếu dữ liệu doanh thu được trả về trong báo cáo này. Nếu không, phương diện này sẽ trả về false. Người dùng GA có quy định hạn chế về No Revenue Metrics không thể xem chỉ số doanh thu. Phương diện này sẽ luôn là false trong khi quy định hạn chế đó có hiệu lực. Để tìm hiểu thêm, hãy xem bài viết Quản lý quyền truy cập và quy định hạn chế về dữ liệu. |
| userCountry | QG của người dùng | Tài sản Google Analytics 360 | Quốc gia của người dùng GA đã truy cập vào dữ liệu báo cáo GA. |
| userCountryId | Mã quốc gia của người dùng | Tài sản Google Analytics 360 | Mã quốc gia của người dùng GA đã truy cập vào dữ liệu báo cáo GA. Được định dạng theo tiêu chuẩn ISO 3166-1 alpha-2. |
| userEmail | Email người dùng | Tất cả tài sản Google Analytics | Email của người dùng GA đã truy cập vào dữ liệu báo cáo GA. Một số chế độ tích hợp cho phép người dùng truy cập vào dữ liệu báo cáo GA thông qua quy trình tích hợp mà không cần người dùng có quyền truy cập trực tiếp vào tài sản. Trong trường hợp đó, userEmail sẽ trả về, ví dụ như Google Ads Linked User, tuỳ thuộc vào chế độ tích hợp. |
| userIP | IP người dùng | Tài sản Google Analytics 360 | IP của người dùng GA đã truy cập vào dữ liệu báo cáo GA. |
Chỉ số
Bạn có thể yêu cầu các chỉ số sau trong báo cáo quyền truy cập dữ liệu. Chỉ định "Tên API" trong trường chỉ số name của tài nguyên AccessMetric 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 | Các thuộc tính được phép | Nội dung mô tả |
|---|---|---|---|
| accessCount | Số lượt truy cập | Tài sản Google Analytics 360 | Số lần truy cập vào dữ liệu báo cáo GA. |
| dataApiQuotaPropertyTokensConsumed | Số mã thông báo thuộc tính hạn mức API dữ liệu đã sử dụng | Tất cả tài sản Google Analytics | Trả về tổng mã thông báo hạn mức thuộc tính đã sử dụng cho các yêu cầu Data API. |