Menampilkan laporan pivot yang disesuaikan untuk data peristiwa Google Analytics Anda. Laporan pivot memiliki format yang lebih canggih dan ekspresif daripada laporan biasa. Dalam laporan pivot, dimensi hanya terlihat jika disertakan dalam pivot. Beberapa pivot dapat ditentukan untuk menganalisis data Anda lebih lanjut.
Permintaan HTTP
POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport
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. Dalam permintaan batch, properti ini harus tidak ditentukan atau konsisten dengan properti tingkat batch. Contoh: properti/1234 |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{ "dimensions": [ { object ( |
Kolom | |
---|---|
dimensions[] |
Dimensi yang diminta. Semua dimensi yang ditentukan harus digunakan oleh salah satu dari berikut ini: dimensionExpression, dimensionsFilter, pivots, orderBys. |
metrics[] |
Metrik yang diminta, minimal satu metrik harus ditentukan. Semua metrik yang ditentukan harus digunakan oleh salah satu dari berikut: metric_expression, metricFilter, orderBys. |
dateRanges[] |
Rentang tanggal untuk mengambil data peristiwa untuk laporan. Jika beberapa rentang tanggal ditentukan, data peristiwa dari setiap rentang tanggal akan digunakan dalam laporan. Dimensi khusus dengan nama kolom "dateRange" dapat disertakan dalam nama kolom Pivot' jika disertakan, laporan akan membandingkan di antara rentang tanggal. Dalam permintaan kelompok, |
pivots[] |
Menjelaskan format visual dimensi laporan dalam kolom atau baris. Gabungan kolomNames (nama dimensi) di semua pivot harus merupakan subset nama dimensi yang ditentukan dalam Dimensi. Tidak ada dua pivot yang dapat berbagi dimensi. Dimensi hanya terlihat jika muncul dalam pivot. |
dimensionFilter |
Klausa filter dimensi. Dimensi harus diminta untuk digunakan dalam filter ini. Metrik tidak dapat digunakan dalam filter ini. |
metricFilter |
Klausa filter metrik. Diterapkan pada fase pasca-agregasi, mirip dengan SQL yang memiliki klausa. Metrik harus diminta untuk digunakan dalam filter ini. Dimensi tidak dapat digunakan di filter ini. |
currencyCode |
Kode mata uang dalam format ISO4217, seperti "AED", "USD", "JPY". Jika kolom kosong, laporan akan menggunakan mata uang default properti. |
cohortSpec |
Grup kelompok yang terkait dengan permintaan ini. Jika ada grup kelompok dalam permintaan, dimensi 'cohort' harus ada. |
keepEmptyRows |
Jika salah atau tidak ditentukan, setiap baris dengan semua metrik yang sama dengan 0 tidak akan ditampilkan. Jika benar, baris ini akan ditampilkan jika tidak dihapus secara terpisah oleh filter. |
returnPropertyQuota |
Mengalihkan apakah akan menampilkan status kuota Properti Analytics saat ini. Kuota ditampilkan di PropertyQuota. |
Isi respons
Jika berhasil, isi respons memuat instance RunPivotReportResponse
.
Cakupan Otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics