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 peristiwa dan data penggunaan selama jangka waktu mulai dari momen 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 Realtime.
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, bukan di bagian 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 pasca-agregasi, mirip dengan SQL yang memiliki klausa. Dimensi tidak dapat digunakan di filter ini. |
limit |
Jumlah baris yang akan ditampilkan. Jika tidak ditentukan, 10.000 baris akan ditampilkan. API tersebut menampilkan maksimum 100.000 baris per permintaan, berapa pun jumlah yang Anda minta. API juga dapat menampilkan lebih sedikit baris daripada |
metricAggregations[] |
Gabungan metrik. Nilai metrik gabungan akan ditampilkan di baris dengan dimensionValues ditetapkan ke "RESERVED_(MetricAggregation)". |
orderBys[] |
Menentukan cara baris diurutkan dalam respons. |
returnPropertyQuota |
Mengalihkan apakah akan menampilkan status kuota Realtime Properti Analytics saat ini. Kuota ditampilkan di PropertyQuota. |
minuteRanges[] |
Rentang menit data peristiwa untuk 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 disertakan dalam baris respons untuk kedua rentang menit tersebut. |
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Tabel laporan realtime respons yang sesuai dengan permintaan.
Representasi JSON |
---|
{ "dimensionHeaders": [ { object ( |
Kolom | |
---|---|
dimensionHeaders[] |
Menjelaskan kolom dimensi. Jumlah DimensionHeaders dan pengurutan DimensionHeaders cocok dengan dimensi yang ada dalam baris. |
metricHeaders[] |
Menjelaskan kolom metrik. Jumlah MetricHeaders dan pengurutan 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 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 untuk 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 hingga rentang 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 selama beberapa menit sebelumnya. Misalnya, Jika tidak ditentukan, nilai |
endMinutesAgo |
Menit akhir inklusif untuk kueri sebagai jumlah menit sebelumnya. Tidak boleh sebelum Jika tidak ditentukan, setelan defaultnya adalah |