Menampilkan laporan data peristiwa realtime yang disesuaikan untuk properti Anda. Peristiwa muncul di laporan realtime beberapa detik setelah dikirim ke Google Analytics. Laporan Real-Time menampilkan data peristiwa dan penggunaan untuk jangka waktu yang berkisar dari saat ini hingga 30 menit yang lalu (hingga 60 menit untuk properti Google Analytics 360).
Untuk panduan membuat permintaan realtime dan memahami respons, lihat artikel Membuat Laporan Real-Time.
Permintaan HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runRealtimeReport
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
property |
ID properti GA4 Google Analytics yang peristiwanya dilacak. Ditentukan dalam jalur URL dan bukan isi. Untuk mempelajari lebih lanjut, lihat tempat menemukan ID Properti. Contoh: properti/1234 |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "dimensions": [ { object ( |
Kolom | |
---|---|
dimensions[] |
Dimensi yang diminta dan ditampilkan. |
metrics[] |
Metrik yang diminta dan ditampilkan. |
dimensionFilter |
Klausa filter dimensi. Metrik tidak dapat digunakan dalam filter ini. |
metricFilter |
Klausa filter metrik. Diterapkan pada fase pascaagregasi, mirip dengan klausa memiliki SQL. Dimensi tidak dapat digunakan dalam filter ini. |
limit |
Jumlah baris yang perlu ditampilkan. Jika tidak ditentukan, 10.000 baris akan ditampilkan. API menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. API juga dapat menampilkan baris yang lebih sedikit dari |
metricAggregations[] |
Agregasi metrik. Nilai metrik gabungan akan ditampilkan di baris tempat dimensionsValues ditetapkan ke "RESERVED_(MetricAgregasi)". |
orderBys[] |
Menentukan bagaimana baris diurutkan dalam respons. |
returnPropertyQuota |
Beralih apakah akan menampilkan status saat ini dari kuota Realtime Properti Analytics ini. Kuota ditampilkan dalam PropertyQuota. |
minuteRanges[] |
Rentang menit data peristiwa yang akan dibaca. Jika tidak ditentukan, rentang satu menit selama 30 menit terakhir akan digunakan. Jika beberapa rentang menit diminta, setiap baris respons akan berisi indeks rentang menit berbasis nol. Jika rentang dua menit tumpang-tindih, data peristiwa untuk menit yang tumpang-tindih akan disertakan dalam baris respons untuk kedua rentang menit tersebut. |
Isi respons
Tabel laporan real-time respons yang sesuai dengan permintaan.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "dimensionHeaders": [ { object ( |
Kolom | |
---|---|
dimensionHeaders[] |
Menjelaskan kolom dimensi. Jumlah DimensionHeader dan urutan DimensionHeaders cocok dengan dimensi yang ada dalam baris. |
metricHeaders[] |
Menjelaskan kolom metrik. Jumlah MetricHeader dan urutan MetricHeaders cocok dengan metrik yang ada di baris. |
rows[] |
Baris kombinasi nilai dimensi dan nilai metrik dalam laporan. |
totals[] |
Jika diminta, total nilai metrik. |
maximums[] |
Jika diminta, nilai metrik maksimum. |
minimums[] |
Jika diminta, nilai minimum metrik. |
rowCount |
Jumlah total baris dalam hasil kueri. |
propertyQuota |
Status kuota Realtime Properti Analytics ini termasuk permintaan ini. |
kind |
Mengidentifikasi jenis resource pesan ini. |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Rentang Menit
Kumpulan menit yang berdekatan: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. Permintaan diizinkan dengan rentang hingga 2 menit.
Representasi JSON |
---|
{ "name": string, "startMinutesAgo": integer, "endMinutesAgo": integer } |
Kolom | |
---|---|
name |
Menetapkan nama untuk rentang menit ini. Dimensi |
startMinutesAgo |
Menit mulai inklusif untuk kueri dalam jumlah menit sebelum sekarang. Misalnya, Jika tidak ditentukan, |
endMinutesAgo |
Menit akhir inklusif untuk kueri dalam jumlah menit sebelum sekarang. Tidak boleh sebelum Jika tidak ditentukan, |