- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- MinuteRange
- Hãy làm thử!
Trả về báo cáo tuỳ chỉnh về dữ liệu sự kiện theo thời gian thực cho tài sản của bạn. Các sự kiện xuất hiện trong báo cáo theo thời gian thực vài giây sau khi chúng được gửi đến Google Analytics. Báo cáo theo thời gian thực hiển thị các sự kiện và dữ liệu sử dụng trong các khoảng thời gian từ thời điểm hiện tại đến 30 phút trước (tối đa 60 phút đối với tài sản Google Analytics 360).
Để được hướng dẫn tạo yêu cầu theo thời gian thực và để hiểu rõ câu trả lời, hãy xem bài viết Tạo Báo cáo theo thời gian thực.
Yêu cầu HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
property |
Giá trị nhận dạng tài sản GA4 của Google Analytics có các sự kiện được theo dõi. Được chỉ định trong đường dẫn URL chứ không phải nội dung. Để tìm hiểu thêm, hãy xem nơi xem Mã tài sản. Ví dụ: thuộc tính/1234 |
Nội dung yêu cầu
Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "dimensions": [ { object ( |
Trường | |
---|---|
dimensions[] |
Các phương diện được yêu cầu và hiển thị. |
metrics[] |
Các chỉ số được yêu cầu và được hiển thị. |
dimensionFilter |
Mệnh đề bộ lọc của phương diện. Không thể sử dụng chỉ số trong bộ lọc này. |
metricFilter |
Mệnh đề bộ lọc của chỉ số. Được áp dụng ở giai đoạn sau khi tổng hợp, tương tự như mệnh đề SQL. Không thể sử dụng các phương diện trong bộ lọc này. |
limit |
Số hàng cần trả về. Nếu không chỉ định, hệ thống sẽ trả về 10.000 hàng. API sẽ trả về tối đa 250.000 hàng cho mỗi yêu cầu, bất kể bạn yêu cầu bao nhiêu hàng. API cũng có thể trả về ít hàng hơn so với |
metricAggregations[] |
Tổng hợp các chỉ số. Các giá trị chỉ số được tổng hợp sẽ hiển thị trong những hàng mà giá trị tham số được đặt thành "RESERVED_(MetricTổng hợp)". |
orderBys[] |
Chỉ định cách sắp xếp các hàng trong phản hồi. |
returnPropertyQuota |
Bật/tắt tính năng trả về trạng thái hiện tại của hạn mức theo thời gian thực của Tài sản Analytics này. Hạn mức được trả về trong PropertyQuota. |
minuteRanges[] |
Phạm vi phút của dữ liệu sự kiện cần đọc. Nếu bạn không chỉ định, phạm vi 1 phút cho 30 phút cuối cùng sẽ được sử dụng. Nếu bạn yêu cầu phạm vi phút nhiều lần, mỗi hàng phản hồi sẽ chứa một chỉ mục phạm vi phút dựa trên 0. Nếu phạm vi 2 phút trùng lặp, thì dữ liệu sự kiện cho số phút bị trùng lặp sẽ được đưa vào các hàng phản hồi cho cả hai phạm vi phút. |
Nội dung phản hồi
Bảng báo cáo phản hồi theo thời gian thực tương ứng với một yêu cầu.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{ "dimensionHeaders": [ { object ( |
Trường | |
---|---|
dimensionHeaders[] |
Mô tả các cột phương diện. Số lượng Kích thước và thứ tự của tham số này khớp với các phương diện có trong các hàng. |
metricHeaders[] |
Mô tả các cột chỉ số. Số lượng metricHeaders và thứ tự của MetricsHeaders khớp với các chỉ số có trong các hàng. |
rows[] |
Các hàng gồm các tổ hợp giá trị phương diện và giá trị chỉ số trong báo cáo. |
totals[] |
Đây là giá trị tổng của các chỉ số (nếu được yêu cầu). |
maximums[] |
Giá trị tối đa của các chỉ số (nếu được yêu cầu). |
minimums[] |
Giá trị tối thiểu của các chỉ số (nếu được yêu cầu). |
rowCount |
Tổng số hàng trong kết quả truy vấn. |
propertyQuota |
Trạng thái hạn mức theo thời gian thực của Tài sản Analytics này, bao gồm cả yêu cầu này. |
kind |
Xác định loại tài nguyên của thông báo. |
Phạm vi uỷ quyền
Yêu cầu một trong các phạm vi OAuth sau:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
MinuteRange
Một tập hợp phút liền nhau: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. Yêu cầu được cho phép trong phạm vi tối đa 2 phút.
Biểu diễn dưới dạng JSON |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Trường | |
---|---|
name |
Gán tên cho phạm vi phút này. Phương diện |
startMinutesAgo |
Phút bắt đầu bao gồm cho truy vấn dưới dạng số phút trước thời điểm hiện tại. Ví dụ: Nếu bạn không chỉ định, |
endMinutesAgo |
Phút kết thúc bao gồm cho truy vấn dưới dạng số phút trước thời điểm hiện tại. Không được trước Nếu bạn không chỉ định, |