Menampilkan laporan kustom data peristiwa realtime untuk properti Anda. Peristiwa muncul di laporan real-time beberapa detik setelah dikirim ke Google Analytics. Laporan Real-Time menampilkan peristiwa dan data penggunaan untuk periode waktu mulai dari saat ini hingga 30 menit yang lalu (hingga 60 menit untuk properti Google Analytics 360).
Untuk panduan membuat permintaan realtime & memahami respons, lihat 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. Ditetapkan di jalur URL, bukan di bagian isi. Untuk mempelajari lebih lanjut, lihat tempat menemukan ID Properti Anda. Contoh: properties/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 pasca agregasi, mirip dengan klausa SQL. Dimensi tidak dapat digunakan dalam filter ini. |
limit |
Jumlah baris yang akan ditampilkan. Jika tidak ditentukan, total 10.000 baris akan ditampilkan. API ini menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. API juga dapat menampilkan lebih sedikit baris daripada |
metricAggregations[] |
Agregasi metrik. Nilai metrik gabungan akan ditampilkan di baris tempat dimensionValues ditetapkan ke "RESERVED_(MetricAggregation)". |
orderBys[] |
Menentukan cara baris diurutkan dalam respons. |
returnPropertyQuota |
Mengalihkan apakah akan menampilkan status saat ini dari kuota Realtime Properti Analytics ini. Kuota ditampilkan di PropertyQuota. |
minuteRanges[] |
Rentang menit data peristiwa yang akan dibaca. Jika tidak ditentukan, rentang satu menit selama 30 menit terakhir akan digunakan. Jika rentang beberapa 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 dimasukkan ke 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[] |
Mendeskripsikan kolom dimensi. Jumlah DimensionHeader dan urutan DimensionHeader cocok dengan dimensi yang ada dalam baris. |
metricHeaders[] |
Menjelaskan kolom metrik. Jumlah MetricHeader dan urutan MetricHeader cocok dengan metrik yang ada dalam baris. |
rows[] |
Baris kombinasi nilai dimensi dan nilai metrik dalam laporan. |
totals[] |
Total nilai metrik jika diminta. |
maximums[] |
Jika diminta, nilai maksimum metrik. |
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
MinuteRange
Kumpulan menit yang berdekatan: startMinutesAgo
, startMinutesAgo + 1
, ..., endMinutesAgo
. Permintaan diizinkan untuk 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 sebagai jumlah menit sebelum sekarang. Misalnya, Jika tidak ditentukan, |
endMinutesAgo |
Menit akhir inklusif untuk kueri sebagai jumlah menit sebelum sekarang. Tidak boleh sebelum Jika tidak ditentukan, |