Các phương diện và chỉ số được hỗ trợ trong truy vấn đến phương thức Báo cáo truy cập 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 | Thuộc tính được phép | Mô tả |
|---|---|---|---|
accessDateHour |
Ngày và giờ truy cập | Tất cả tài sản Google Analytics | Ngày và giờ người dùng GA đã truy cập vào dữ liệu báo cáo GA. Có định dạng là YYYYMMDDHH. |
accessMechanism |
Cơ chế truy cập | Tài sản Google Analytics 360 | Cơ chế mà người dùng GA đã truy cập vào dữ liệu báo cáo GA. Giá trị có thể có bao gồm: "Giao diện người dùng Google Analytics", "API Google Analytics", "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à người dùng đã truy cập vào dữ liệu báo cáo GA. Hầu hết Báo cáo truy cập dữ liệu chỉ chứa thông tin về 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 dữ liệu truy cập vào cả tài sản nguồn và tài sản phụ. Để tìm hiểu thêm, hãy xem bài viết giới thiệu về tài sản phụ. |
accessedPropertyName |
Tên tài sản đã truy cập | Tất cả tài sản Google Analytics | Tên hiển thị của tài sản mà người dùng đã truy cập vào dữ liệu báo cáo trên GA. Hầu hết Báo cáo truy cập dữ liệu chỉ chứa thông tin về 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 dữ liệu truy cập vào cả tài sản nguồn và tài sản phụ. Để tìm hiểu thêm, 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 trên Google Analytics. Bạn cấp cho các ứng dụng và dịch vụ bên thứ ba quyền xem dữ liệu báo cáo của bạn trên Google Analytics. Để tìm hiểu thêm, hãy xem bài viết quản lý mối liên kết giữa Tài khoản Google của bạn và các bên thứ ba. |
costDataReturned |
Dữ liệu chi phí được 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. Những người dùng GA được đặt hạn chế là "Không xem chỉ số về chi phí" sẽ không thể xem các chỉ số về chi phí. Phương diện này sẽ luôn có giá trị là false khi áp dụng hạn chế đó. Để tìm hiểu thêm, hãy xem bài viết Quản lý quyền truy cập và quy tắc hạn chế về dữ liệu. |
dataApiQuotaCategory |
Danh mục hạn mức Data API | 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ể sử dụng là: "Lõi", "Theo thời gian thực" và "Phễu". |
epochTimeMicros |
Thời gian bắt đầu của hệ thống (tính theo micrô giây) | Tài sản Google Analytics 360 | Số micro giây Unix kể từ thời gian bắt đầu mà người dùng GA truy cập vào dữ liệu báo cáo GA. Ví dụ: một micro giây Unix là "1655220215027371" tương ứng với ngày 14 tháng 6 năm 2022 11:23:35 theo múi giờ America/New_York. |
mostRecentAccessEpochTimeMicros |
Thời gian truy cập gần đây nhất theo thời gian bắt đầu của hệ thống (tính theo micrô giây) | 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ề theo micrô giây Unix 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 thời gian 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ể là: "Báo cáo", "Thời gian thực", "Khám phá biểu mẫu tuỳ ý", "Khám phá phễu" và các giá trị khác. |
revenueDataReturned |
Dữ liệu doanh thu được trả lại | 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. Những người dùng GA được đặt hạn chế là "Không xem chỉ số về doanh thu" sẽ không thể xem các chỉ số về doanh thu. Phương diện này sẽ luôn có giá trị là false khi áp dụng hạn chế đó. Để tìm hiểu thêm, hãy xem bài viết Quản lý quyền truy cập và quy tắc hạn chế về dữ liệu. |
userCountry |
Quốc gia 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ố công cụ tích hợp cho phép người dùng truy cập vào dữ liệu báo cáo trên GA thông qua công cụ 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; ví dụ: trong trường hợp đó, "userEmail" sẽ trả về giá trị "Người dùng được liên kết với Google Ads", tuỳ thuộc vào công cụ 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 name của chỉ số của tài nguyên AccessMetric 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 | Thuộc tính được phép | 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. Khi sử dụng Giao diện người dùng Google Analytics, mỗi thẻ báo cáo có thể dẫn đến một hoặc nhiều sự kiện truy cập dữ liệu. Do đó, việc di chuyển qua Giao diện người dùng của Google Analytics có thể dẫn đến nhiều sự kiện truy cập hơn số lượng báo cáo đã xem. |
dataApiQuotaPropertyTokensConsumed |
Số lượng mã thông báo tài sản đã sử dụng trong hạn mức Data API | Tất cả tài sản Google Analytics | Trả về tổng số mã thông báo hạn mức của tài sản đã sử dụng cho các yêu cầu Data API. |