Method: properties.runPivotReport

Menampilkan laporan pivot kustom dari data peristiwa Google Analytics Anda. Laporan pivot adalah format yang lebih canggih dan ekspresif daripada laporan biasa. Dalam laporan pivot, dimensi hanya dapat dilihat jika disertakan dalam pivot. Beberapa pivot dapat ditentukan untuk menganalisis data lebih lanjut.

Permintaan HTTP

POST https://analyticsdata.googleapis.com/v1beta/{property=properties/*}:runPivotReport

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
property

string

ID properti GA4 Google Analytics yang peristiwanya dilacak. Ditentukan di jalur URL, bukan di bagian isi. Untuk mempelajari lebih lanjut, lihat tempat menemukan ID Properti Anda. Dalam permintaan batch, properti ini harus tidak ditentukan atau konsisten dengan properti tingkat batch.

Contoh: properties/1234

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "dimensions": [
    {
      object (Dimension)
    }
  ],
  "metrics": [
    {
      object (Metric)
    }
  ],
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "pivots": [
    {
      object (Pivot)
    }
  ],
  "dimensionFilter": {
    object (FilterExpression)
  },
  "metricFilter": {
    object (FilterExpression)
  },
  "currencyCode": string,
  "cohortSpec": {
    object (CohortSpec)
  },
  "keepEmptyRows": boolean,
  "returnPropertyQuota": boolean,
  "comparisons": [
    {
      object (Comparison)
    }
  ]
}
Kolom
dimensions[]

object (Dimension)

Dimensi yang diminta. Semua dimensi yang ditentukan harus digunakan oleh salah satu dari berikut: dimensionEkspresi, dimensionFilter, pivot, orderBy.

metrics[]

object (Metric)

Metrik yang diminta, setidaknya satu metrik harus ditentukan. Semua metrik yang ditentukan harus digunakan oleh salah satu hal berikut: metric_expression, metricFilter, orderBys.

dateRanges[]

object (DateRange)

Rentang tanggal guna 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 dimasukkan dalam nama {i>field<i} Pivot; jika disertakan, laporan akan membandingkan rentang tanggal. Dalam permintaan kelompok, dateRanges ini harus tidak ditentukan.

pivots[]

object (Pivot)

Menjelaskan format visual dimensi laporan dalam kolom atau baris. Penyatuan fieldNames (nama dimensi) di semua pivot harus berupa subkumpulan nama dimensi yang ditentukan dalam Dimensi. Tidak ada dua pivot yang dapat membagikan dimensi. Dimensi hanya terlihat jika muncul dalam pivot.

dimensionFilter

object (FilterExpression)

Klausa filter dimensi. Dimensi harus diminta agar dapat digunakan dalam filter ini. Metrik tidak dapat digunakan dalam filter ini.

metricFilter

object (FilterExpression)

Klausa filter metrik. Diterapkan pada fase pasca agregasi, mirip dengan klausa SQL. Metrik harus diminta agar digunakan dalam filter ini. Dimensi tidak dapat digunakan dalam filter ini.

currencyCode

string

Kode mata uang dalam format ISO4217, seperti "AED", "USD", "JPY". Jika kolom kosong, laporan akan menggunakan mata uang default properti.

cohortSpec

object (CohortSpec)

Grup kelompok yang terkait dengan permintaan ini. Jika ada grup kelompok dalam permintaan, kolom 'kohor' dimensi kustom harus ada.

keepEmptyRows

boolean

Jika salah atau tidak ditentukan, tiap baris dengan semua metrik yang sama dengan 0 tidak akan ditampilkan. Jika true (benar), baris ini akan ditampilkan jika tidak dihapus secara terpisah oleh filter.

Terlepas dari setelan keepEmptyRows ini, hanya data yang dicatat oleh properti Google Analytics (GA4) yang dapat ditampilkan dalam laporan.

Misalnya, jika properti tidak pernah mencatat peristiwa purchase ke dalam log, kueri untuk dimensi eventName dan metrik eventCount tidak akan memiliki baris eventName: "purchase" dan eventCount: 0.

returnPropertyQuota

boolean

Mengalihkan apakah akan menampilkan status saat ini dari kuota Properti Analytics ini. Kuota ditampilkan di PropertyQuota.

comparisons[]

object (Comparison)

Opsional. Konfigurasi perbandingan diminta dan ditampilkan. Permintaan ini memerlukan kolom perbandingan dan dimensi perbandingan untuk menerima kolom perbandingan dalam respons.

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