Method: properties.runFunnelReport

Menampilkan laporan funnel yang disesuaikan dari data peristiwa Google Analytics Anda. Data yang ditampilkan dari API adalah sebagai tabel dengan kolom untuk dimensi dan metrik yang diminta.

Eksplorasi funnel memungkinkan Anda memvisualisasikan tahapan yang diambil pengguna untuk menyelesaikan aktivitas dan dengan cepat melihat bagaimana keberhasilan atau kegagalan mereka di setiap tahapan. Misalnya, bagaimana calon pembeli menjadi pembelanja, kemudian menjadi pembeli? Bagaimana pembeli satu kali menjadi pembeli berulang? Dengan informasi ini, Anda dapat meningkatkan perjalanan pelanggan yang ditinggalkan atau tidak efisien. Untuk mempelajari lebih lanjut, lihat Eksplorasi Funnel GA4.

Metode ini diperkenalkan di versi alfa yang sudah stabil dengan tujuan mengumpulkan masukan terkait sintaksis dan kemampuan sebelum memasuki versi beta. Untuk memberikan masukan Anda tentang API ini, isi Masukan Pelaporan Funnel Google Analytics Data API.

Permintaan HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{property=properties/*}:runFunnelReport

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
property

string

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

Contoh: properties/1234

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON
{
  "dateRanges": [
    {
      object (DateRange)
    }
  ],
  "funnel": {
    object (Funnel)
  },
  "funnelBreakdown": {
    object (FunnelBreakdown)
  },
  "funnelNextAction": {
    object (FunnelNextAction)
  },
  "funnelVisualizationType": enum (FunnelVisualizationType),
  "segments": [
    {
      object (Segment)
    }
  ],
  "limit": string,
  "dimensionFilter": {
    object (FilterExpression)
  },
  "returnPropertyQuota": boolean
}
Kolom
dateRanges[]

object (DateRange)

Opsional. Rentang tanggal data yang akan dibaca. Jika beberapa rentang tanggal diminta, setiap baris respons akan berisi indeks rentang tanggal berbasis nol. Jika dua rentang tanggal tumpang-tindih, data peristiwa untuk hari yang tumpang-tindih akan disertakan dalam baris respons untuk kedua rentang tanggal tersebut.

funnel

object (Funnel)

Opsional. Konfigurasi funnel permintaan ini. Konfigurasi funnel ini wajib diisi.

funnelBreakdown

object (FunnelBreakdown)

Opsional. Jika ditentukan, pengelompokan ini akan menambahkan dimensi ke respons sub-laporan tabel funnel. Dimensi perincian ini memperluas setiap tahapan funnel ke nilai unik dimensi perincian. Misalnya, perincian berdasarkan dimensi deviceCategory akan membuat baris untuk mobile, tablet, desktop, dan total.

funnelNextAction

object (FunnelNextAction)

Opsional. Jika ditentukan, tindakan berikutnya akan menambahkan dimensi ke respons sub-laporan visualisasi funnel. Dimensi tindakan berikutnya ini memperluas setiap tahapan funnel ke nilai unik untuk tindakan berikutnya. Misalnya, tindakan dimensi eventName berikutnya akan membuat baris untuk beberapa peristiwa (misalnya session_start & click) dan totalnya.

Tindakan berikutnya hanya mendukung eventName dan sebagian besar dimensi Halaman / Layar seperti pageTitle dan pagePath.

funnelVisualizationType

enum (FunnelVisualizationType)

Opsional. Jenis visualisasi funnel mengontrol dimensi yang ada di respons sub-laporan visualisasi funnel. Jika tidak ditentukan, STANDARD_FUNNEL akan digunakan.

segments[]

object (Segment)

Opsional. Konfigurasi segmen. Segmen adalah subkumpulan data properti. Dalam laporan funnel dengan segmen, funnel dievaluasi di setiap segmen.

Setiap segmen yang ditentukan dalam permintaan ini menghasilkan baris terpisah dalam respons; dalam respons, setiap segmen diidentifikasi berdasarkan namanya.

Parameter segmen bersifat opsional. Permintaan dibatasi hingga 4 segmen.

limit

string (int64 format)

Opsional. Jumlah baris yang akan ditampilkan. Jika tidak ditentukan, 10.000 baris akan ditampilkan. API menampilkan maksimum 250.000 baris per permintaan, berapa pun jumlah yang Anda minta. limit harus positif.

API juga dapat menampilkan lebih sedikit baris dari limit yang diminta, jika nilai dimensi tidak sebanyak limit.

dimensionFilter

object (FilterExpression)

Opsional. Filter dimensi memungkinkan Anda meminta nilai dimensi tertentu saja dalam laporan. Untuk mempelajari lebih lanjut, lihat artikel Membuat Laporan: Filter Dimensi untuk mengetahui contohnya. Metrik tidak dapat digunakan di filter ini.

returnPropertyQuota

boolean

Opsional. Mengalihkan apakah akan menampilkan status kuota Properti Analytics saat ini atau tidak. Kuota ditampilkan di PropertyQuota.

Isi respons

Respons laporan funnel berisi dua sub-laporan. Kedua sublaporan tersebut adalah kombinasi dimensi dan metrik yang berbeda.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON
{
  "funnelTable": {
    object (FunnelSubReport)
  },
  "funnelVisualization": {
    object (FunnelSubReport)
  },
  "propertyQuota": {
    object (PropertyQuota)
  },
  "kind": string
}
Kolom
funnelTable

object (FunnelSubReport)

Tabel funnel adalah laporan yang berisi tahapan funnel, segmen, dimensi perincian, pengguna aktif, rasio penyelesaian, pengabaian, dan rasio pengabaian.

Dimensi segmen hanya ada dalam respons ini jika segmen diminta. Dimensi perincian hanya ada dalam respons ini jika diminta.

funnelVisualization

object (FunnelSubReport)

Visualisasi funnel adalah laporan yang berisi dimensi tahapan funnel, segmen, tanggal, tindakan berikutnya, dan pengguna aktif.

Dimensi segmen hanya ada dalam respons ini jika segmen diminta. Dimensi tanggal hanya ada dalam respons ini jika diminta melalui jenis funnel TRENDED_FUNNEL. Dimensi tindakan berikutnya hanya ada dalam respons jika diminta.

propertyQuota

object (PropertyQuota)

Status kuota Properti Analytics ini termasuk permintaan ini.

kind

string

Mengidentifikasi jenis resource pesan ini. kind ini selalu berupa string tetap "analyticsData#runFunnelReport". Berguna untuk membedakan berbagai jenis respons dalam JSON.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

DateRange

Kumpulan hari yang berdekatan: startDate, startDate + 1, ..., endDate. Permintaan diizinkan hingga 4 rentang tanggal.

Representasi JSON
{
  "startDate": string,
  "endDate": string,
  "name": string
}
Kolom
startDate

string

Tanggal mulai inklusif untuk kueri dalam format YYYY-MM-DD. Tidak boleh setelah endDate. Format NdaysAgo, yesterday, atau today juga diterima, dan dengan demikian, tanggalnya ditentukan berdasarkan zona waktu pelaporan properti.

endDate

string

Tanggal akhir inklusif untuk kueri dalam format YYYY-MM-DD. Tidak boleh sebelum startDate. Format NdaysAgo, yesterday, atau today juga diterima, dan dengan demikian, tanggalnya ditentukan berdasarkan zona waktu pelaporan properti.

name

string

Menetapkan nama untuk rentang tanggal ini. Dimensi dateRange bernilai untuk nama ini dalam respons laporan. Jika ditetapkan, tidak boleh diawali dengan date_range_ atau RESERVED_. Jika tidak ditetapkan, rentang tanggal akan diberi nama oleh indeks berbasis nol dalam permintaan: date_range_0, date_range_1, dll.

Funnel

Mengonfigurasi funnel dalam permintaan laporan funnel. Funnel melaporkan pengguna saat mereka melewati urutan langkah.

Eksplorasi funnel memungkinkan Anda memvisualisasikan tahapan yang diambil pengguna untuk menyelesaikan aktivitas dan dengan cepat melihat bagaimana keberhasilan atau kegagalan mereka di setiap tahapan. Misalnya, bagaimana calon pembeli menjadi pembelanja, kemudian menjadi pembeli? Bagaimana pembeli satu kali menjadi pembeli berulang? Dengan informasi ini, Anda dapat meningkatkan perjalanan pelanggan yang ditinggalkan atau tidak efisien.

Representasi JSON
{
  "isOpenFunnel": boolean,
  "steps": [
    {
      object (FunnelStep)
    }
  ]
}
Kolom
isOpenFunnel

boolean

Dalam funnel terbuka, pengguna dapat memasuki funnel pada setiap langkah, dan di funnel tertutup, pengguna harus memasuki funnel pada langkah pertama. Opsional. Jika tidak ditentukan, funnel tertutup akan digunakan.

steps[]

object (FunnelStep)

Langkah-langkah berurutan pada funnel ini.

FunnelStep

Langkah menentukan perjalanan pengguna yang ingin Anda ukur. Langkah-langkah berisi satu atau beberapa kondisi yang harus dipenuhi pengguna Anda untuk disertakan dalam langkah perjalanan funnel tersebut.

Representasi JSON
{
  "name": string,
  "isDirectlyFollowedBy": boolean,
  "filterExpression": {
    object (FunnelFilterExpression)
  },
  "withinDurationFromPriorStep": string
}
Kolom
name

string

Nama unik untuk langkah ini. Jika tidak ditentukan, langkah akan diberi nama dengan nama terindeks berbasis 1 (misalnya "0. ", "1. ", dll.). Nama ini menentukan nilai string yang ditampilkan oleh dimensi funnelStepName. Misalnya, menentukan name = Purchase di tahapan funnel ketiga permintaan akan menghasilkan 3. Purchase di respons laporan funnel.

isDirectlyFollowedBy

boolean

Jika true (benar), langkah ini harus langsung mengikuti langkah sebelumnya. Jika false, mungkin ada peristiwa antara langkah sebelumnya dan langkah ini. Jika tidak ditentukan, isDirectlyFollowedBy akan diperlakukan sebagai salah (false).

filterExpression

object (FunnelFilterExpression)

Kondisi yang harus dipenuhi pengguna Anda untuk disertakan dalam langkah perjalanan funnel ini.

withinDurationFromPriorStep

string (Duration format)

Jika ditentukan, langkah ini harus diselesaikan dalam durasi penyelesaian langkah sebelumnya. withinDurationFromPriorStep mencakup endpoint pada perincian mikrodetik. Misalnya durasi 5 detik dapat diselesaikan pada 4,9 atau 5,0 detik, tetapi tidak 5 detik dan 1 mikrodetik.

withinDurationFromPriorStep bersifat opsional, dan jika tidak ditentukan, langkah dapat dipisahkan berdasarkan durasi waktu.

Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

FunnelFilterExpression

Menunjukkan kombinasi filter funnel.

Representasi JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelFilterExpressionList)
  },
  "orGroup": {
    object (FunnelFilterExpressionList)
  },
  "notExpression": {
    object (FunnelFilterExpression)
  },
  "funnelFieldFilter": {
    object (FunnelFieldFilter)
  },
  "funnelEventFilter": {
    object (FunnelEventFilter)
  }
  // End of list of possible types for union field expr.
}
Kolom
Kolom union expr. Tentukan satu jenis filter untuk FunnelFilterExpression. expr hanya dapat berupa salah satu dari berikut:
andGroup

object (FunnelFilterExpressionList)

FunnelFilterEkspresiion di andGroup memiliki hubungan DAN.

orGroup

object (FunnelFilterExpressionList)

FunnelFilterEkspresiion di orGroup memiliki hubungan ATAU.

notExpression

object (FunnelFilterExpression)

FunnelFilterEkspresiion BUKAN dari notExpression.

funnelFieldFilter

object (FunnelFieldFilter)

Filter funnel untuk dimensi atau metrik.

funnelEventFilter

object (FunnelEventFilter)

Membuat filter yang cocok dengan peristiwa dari satu nama peristiwa. Jika ekspresi filter parameter ditentukan, hanya subkumpulan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter yang cocok dengan filter peristiwa ini.

FunnelFilterExpressionList

Daftar ekspresi filter funnel.

Representasi JSON
{
  "expressions": [
    {
      object (FunnelFilterExpression)
    }
  ]
}
Kolom
expressions[]

object (FunnelFilterExpression)

Daftar ekspresi filter funnel.

FunnelFieldFilter

Ekspresi untuk memfilter nilai dimensi atau metrik.

Representasi JSON
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Kolom
fieldName

string

Nama dimensi atau nama metrik.

Kolom union one_filter. Tentukan satu jenis filter. one_filter hanya ada berupa salah satu diantara berikut:
stringFilter

object (StringFilter)

Filter terkait string.

inListFilter

object (InListFilter)

Filter untuk nilai dalam daftar.

numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.

betweenFilter

object (BetweenFilter)

Filter untuk antara dua nilai.

StringFilter

Filter untuk string

Representasi JSON
{
  "matchType": enum (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Kolom
matchType

enum (MatchType)

Jenis pencocokan untuk filter ini.

value

string

Nilai string yang digunakan untuk pencocokan.

caseSensitive

boolean

Jika true (benar), nilai string peka huruf besar/kecil.

MatchType

Jenis pencocokan filter string

Enum
MATCH_TYPE_UNSPECIFIED Belum ditetapkan
EXACT Pencocokan persis dari nilai string.
BEGINS_WITH Dimulai dengan nilai string.
ENDS_WITH Berakhir dengan nilai string.
CONTAINS Berisi nilai string.
FULL_REGEXP Kecocokan penuh untuk ekspresi reguler dengan nilai string.
PARTIAL_REGEXP Pencocokan sebagian untuk ekspresi reguler dengan nilai string.

InListFilter

Hasilnya harus berada dalam daftar nilai string.

Representasi JSON
{
  "values": [
    string
  ],
  "caseSensitive": boolean
}
Kolom
values[]

string

Daftar nilai string. Tidak boleh kosong.

caseSensitive

boolean

Jika true (benar), nilai string peka huruf besar/kecil.

NumericFilter

Filter untuk nilai numerik atau tanggal.

Representasi JSON
{
  "operation": enum (Operation),
  "value": {
    object (NumericValue)
  }
}
Kolom
operation

enum (Operation)

Jenis operasi untuk filter ini.

value

object (NumericValue)

Nilai numerik atau nilai tanggal.

Operasi

Operasi yang diterapkan pada filter numerik

Enum
OPERATION_UNSPECIFIED Tidak ditentukan.
EQUAL Sama dengan
LESS_THAN Kurang dari
LESS_THAN_OR_EQUAL Kurang dari atau sama dengan
GREATER_THAN Lebih dari
GREATER_THAN_OR_EQUAL Lebih dari atau sama dengan

NumericValue

Untuk mewakili angka.

Representasi JSON
{

  // Union field one_value can be only one of the following:
  "int64Value": string,
  "doubleValue": number
  // End of list of possible types for union field one_value.
}
Kolom
Kolom union one_value. Salah satu dari nilai numerik one_value hanya dapat berupa salah satu dari berikut ini:
int64Value

string (int64 format)

Nilai bilangan bulat

doubleValue

number

Nilai ganda

BetweenFilter

Untuk menyatakan bahwa hasilnya harus berada di antara dua angka (inklusif).

Representasi JSON
{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}
Kolom
fromValue

object (NumericValue)

Dimulai dengan angka ini.

toValue

object (NumericValue)

Berakhir dengan angka ini.

FunnelEventFilter

Membuat filter yang cocok dengan peristiwa dari satu nama peristiwa. Jika ekspresi filter parameter ditentukan, hanya subkumpulan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter yang cocok dengan filter peristiwa ini.

Representasi JSON
{
  "eventName": string,
  "funnelParameterFilterExpression": {
    object (FunnelParameterFilterExpression)
  }
}
Kolom
eventName

string

Filter ini cocok dengan peristiwa dari satu nama peristiwa ini. Nama peristiwa wajib diisi.

funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

Jika ditentukan, filter ini akan mencocokkan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter.

Di dalam ekspresi filter parameter, hanya filter parameter yang tersedia.

FunnelParameterFilterExpression

Menunjukkan kombinasi filter funnel pada parameter.

Representasi JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "orGroup": {
    object (FunnelParameterFilterExpressionList)
  },
  "notExpression": {
    object (FunnelParameterFilterExpression)
  },
  "funnelParameterFilter": {
    object (FunnelParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Kolom
Kolom union expr. Tentukan satu jenis filter untuk FunnelParameterFilterExpression. expr hanya dapat berupa salah satu dari berikut:
andGroup

object (FunnelParameterFilterExpressionList)

FunnelParameterFilterEkspresiion di andGroup memiliki hubungan DAN.

orGroup

object (FunnelParameterFilterExpressionList)

FunnelParameterFilterEkspresiion di orGroup memiliki hubungan ATAU.

notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterEkspresiion BUKAN dari notExpression.

funnelParameterFilter

object (FunnelParameterFilter)

Filter parameter funnel primitif.

FunnelParameterFilterExpressionList

Daftar ekspresi filter parameter funnel.

Representasi JSON
{
  "expressions": [
    {
      object (FunnelParameterFilterExpression)
    }
  ]
}
Kolom
expressions[]

object (FunnelParameterFilterExpression)

Daftar ekspresi filter parameter funnel.

FunnelParameterFilter

Ekspresi untuk memfilter nilai parameter di funnel.

Representasi JSON
{

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Kolom
Kolom union one_parameter. Kolom yang sedang difilter. one_parameter hanya ada berupa salah satu diantara berikut:
eventParameterName

string

Filter ini akan dievaluasi berdasarkan parameter peristiwa yang ditentukan. Parameter peristiwa dicatat sebagai parameter peristiwa. Parameter peristiwa menyertakan kolom seperti "firebase_screen" & "currency".

Parameter peristiwa hanya dapat digunakan dalam segmen & funnel, serta hanya dapat digunakan dalam filter turunan dari EventFilter. Dalam filter turunan dari EventFilter, parameter peristiwa atau item harus digunakan.

itemParameterName

string

Filter ini akan dievaluasi pada parameter item yang ditentukan. Parameter item dicatat sebagai parameter dalam array item. Parameter item mencakup kolom seperti "item_name" & "item_category".

Parameter item hanya dapat digunakan dalam segmen & funnel, serta hanya dapat digunakan di filter turunan dari EventFilter. Dalam filter turunan dari EventFilter, parameter peristiwa atau item harus digunakan.

Parameter item hanya tersedia di peristiwa e-commerce. Untuk mempelajari peristiwa e-commerce lebih lanjut, lihat panduan Mengukur e-commerce.

Kolom union one_filter. Tentukan satu jenis filter. one_filter hanya ada berupa salah satu diantara berikut:
stringFilter

object (StringFilter)

Filter terkait string.

inListFilter

object (InListFilter)

Filter untuk nilai dalam daftar.

numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.

betweenFilter

object (BetweenFilter)

Filter untuk antara dua nilai.

FunnelBreakdown

Pengelompokan menambahkan dimensi ke respons sub-laporan tabel funnel.

Representasi JSON
{
  "breakdownDimension": {
    object (Dimension)
  },
  "limit": string
}
Kolom
breakdownDimension

object (Dimension)

Kolom dimensi ditambahkan ke respons sublaporan tabel funnel. Dimensi perincian mengelompokkan setiap tahapan funnel. breakdownDimension yang valid diperlukan jika funnelBreakdown ditentukan.

limit

string (int64 format)

Jumlah maksimum nilai yang berbeda dari dimensi perincian yang akan ditampilkan dalam respons. limit dari 5 digunakan jika batas tidak ditentukan. Batasnya harus melebihi nol dan tidak boleh lebih dari 15.

Dimensi

Dimensi merupakan atribut data Anda. Misalnya, kota dimensi menunjukkan kota tempat peristiwa berasal. Nilai dimensi dalam respons laporan adalah string; misalnya, kota dapat berupa "Paris" atau "New York".

Representasi JSON
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
Kolom
name

string

Nama dimensi. Lihat Dimensi API untuk mengetahui daftar nama dimensi yang didukung oleh metode pelaporan inti seperti runReport dan batchRunReports. Lihat Dimensi Realtime untuk mengetahui daftar nama dimensi yang didukung oleh metode runRealtimeReport. Lihat Dimensi Funnel untuk daftar nama dimensi yang didukung oleh metode runFunnelReport.

Jika dimensionExpression ditentukan, name dapat berupa string apa pun yang Anda inginkan dalam himpunan karakter yang diizinkan. Misalnya, jika dimensionExpression menggabungkan country dan city, Anda dapat memanggil dimensi tersebut countryAndCity. Nama dimensi yang Anda pilih harus cocok dengan ekspresi reguler ^[a-zA-Z0-9_]$.

Dimensi dirujuk oleh name di dimensionFilter, orderBys, dimensionExpression, dan pivots.

dimensionExpression

object (DimensionExpression)

Satu dimensi dapat merupakan hasil dari ekspresi beberapa dimensi. Misalnya, dimensi "country, city": concatenate(country, ", ", city).

DimensionExpression

Digunakan untuk menyatakan dimensi yang merupakan hasil dari rumus beberapa dimensi. Contoh penggunaan: 1) {i>lowerCase<i} (dimensi) 2) {i>concatenate<i} (dimensi1, simbol, dimensi2).

Representasi JSON
{

  // Union field one_expression can be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union field one_expression.
}
Kolom
Kolom union one_expression. Tentukan satu jenis ekspresi dimensi untuk DimensionExpression. one_expression hanya dapat berupa salah satu dari berikut:
lowerCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi ke huruf kecil.

upperCase

object (CaseExpression)

Digunakan untuk mengonversi nilai dimensi menjadi huruf besar.

concatenate

object (ConcatenateExpression)

Digunakan untuk menggabungkan nilai dimensi ke satu dimensi. Misalnya, dimensi "country, city": concatenate(country, ", ", city).

CaseExpression

Digunakan untuk mengonversi nilai dimensi menjadi satu kasus.

Representasi JSON
{
  "dimensionName": string
}
Kolom
dimensionName

string

Nama dimensi. Nama tersebut harus merujuk kembali ke nama di kolom dimensi permintaan.

ConcatenateExpression

Digunakan untuk menggabungkan nilai dimensi ke satu dimensi.

Representasi JSON
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
Kolom
dimensionNames[]

string

Nama dimensi. Nama tersebut harus merujuk kembali ke nama di kolom dimensi permintaan.

delimiter

string

Pemisah ditempatkan di antara nama dimensi.

Pemisah sering kali berupa karakter tunggal seperti "|" atau "," tetapi bisa berupa string yang lebih panjang. Jika nilai dimensi berisi pembatas, keduanya akan ditampilkan sebagai respons tanpa perbedaan. Misalnya, jika nilai dimensi 1 = "US,FR", nilai dimensi 2 = "JP", dan pembatas = ",", respons akan berisi "US,FR,JP".

FunnelNextAction

Tindakan berikutnya menyatakan nilai untuk dimensi setelah pengguna mencapai langkah, tetapi sebelum pengguna yang sama mencapai langkah berikutnya. Misalnya, jika nextActionDimension adalah eventName, nextActionDimension di baris tahapan funnel ke-i akan menampilkan peristiwa pertama setelah peristiwa yang membuat pengguna memenuhi syarat untuk memasuki tahapan funnel ke-i, tetapi sebelum pengguna mencapai tahapan funnel ke-i+1.

Representasi JSON
{
  "nextActionDimension": {
    object (Dimension)
  },
  "limit": string
}
Kolom
nextActionDimension

object (Dimension)

Kolom dimensi ditambahkan ke respons sub-laporan visualisasi funnel. Dimensi tindakan berikutnya menampilkan nilai dimensi berikutnya dari dimensi ini setelah pengguna mencapai tahapan funnel ke-i.

nextActionDimension saat ini hanya mendukung eventName dan sebagian besar dimensi Halaman / Layar seperti pageTitle dan pagePath. nextActionDimension tidak boleh berupa ekspresi dimensi.

limit

string (int64 format)

Jumlah maksimum nilai yang berbeda dari dimensi perincian yang akan ditampilkan dalam respons. limit dari 5 digunakan jika batas tidak ditentukan. Batasnya harus lebih dari nol dan tidak boleh lebih dari 5.

FunnelVisualizationType

Mengontrol dimensi yang ada di respons sub-laporan visualisasi funnel.

Enum
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Jenis tidak ditentukan.
STANDARD_FUNNEL Funnel standar (berundak). Sublaporan visualisasi funnel dalam respons tidak akan berisi tanggal.
TRENDED_FUNNEL Funnel tren (diagram garis). Sublaporan visualisasi funnel dalam respons akan berisi dimensi tanggal.

Segmen

Segmen adalah subkumpulan data Analytics Anda. Misalnya, dari seluruh kumpulan pengguna, satu segmen mungkin adalah pengguna dari negara atau kota tertentu. Segmen lain mungkin adalah pengguna yang membeli lini produk tertentu, mengunjungi bagian tertentu di situs Anda, atau memicu peristiwa tertentu di aplikasi Anda.

Untuk mempelajari lebih lanjut, lihat Pembuat Segmen GA4.

Representasi JSON
{
  "name": string,

  // Union field one_segment_scope can be only one of the following:
  "userSegment": {
    object (UserSegment)
  },
  "sessionSegment": {
    object (SessionSegment)
  },
  "eventSegment": {
    object (EventSegment)
  }
  // End of list of possible types for union field one_segment_scope.
}
Kolom
name

string

Nama untuk segmen ini. Jika tidak ditentukan, segmen akan diberi nama "Segmen". Nama ini menentukan nilai string yang ditampilkan oleh dimensi segment. Awalan dimensi segment nama segmen berdasarkan nomor indeks berbasis 1 dari segmen dalam permintaan (misalnya "1. Segmen", "2. Segmen", dll.).

Kolom union one_segment_scope. Segmen ditentukan dalam satu cakupan. one_segment_scope hanya ada berupa salah satu diantara berikut:
userSegment

object (UserSegment)

Segmen pengguna adalah subkumpulan pengguna yang berinteraksi dengan situs atau aplikasi Anda.

sessionSegment

object (SessionSegment)

Segmen sesi adalah subkumpulan sesi yang terjadi di situs atau aplikasi Anda.

eventSegment

object (EventSegment)

Segmen peristiwa adalah subkumpulan peristiwa yang dipicu di situs atau aplikasi Anda.

UserSegment

Segmen pengguna adalah subkumpulan pengguna yang berinteraksi dengan situs atau aplikasi Anda. Misalnya, pengguna yang sebelumnya telah membeli; pengguna yang menambahkan item ke keranjang belanja mereka, tetapi tidak menyelesaikan pembelian.

Representasi JSON
{
  "userInclusionCriteria": {
    object (UserSegmentCriteria)
  },
  "exclusion": {
    object (UserSegmentExclusion)
  }
}
Kolom
userInclusionCriteria

object (UserSegmentCriteria)

Menentukan pengguna yang disertakan dalam segmen ini. Opsional.

exclusion

object (UserSegmentExclusion)

Menentukan pengguna mana yang dikecualikan dalam segmen ini. Opsional.

UserSegmentCriteria

Pengguna cocok dengan kriteria jika peristiwa pengguna memenuhi kondisi dalam kriteria.

Representasi JSON
{
  "andConditionGroups": [
    {
      object (UserSegmentConditionGroup)
    }
  ],
  "andSequenceGroups": [
    {
      object (UserSegmentSequenceGroup)
    }
  ]
}
Kolom
andConditionGroups[]

object (UserSegmentConditionGroup)

Pengguna cocok dengan kriteria ini jika pengguna cocok dengan setiap andConditionGroups ini dan setiap andSequenceGroups. andConditionGroups boleh kosong jika andSequenceGroups ditentukan.

andSequenceGroups[]

object (UserSegmentSequenceGroup)

Pengguna cocok dengan kriteria ini jika pengguna cocok dengan setiap andSequenceGroups ini dan setiap andConditionGroups. andSequenceGroups boleh kosong jika andConditionGroups ditentukan.

UserSegmentConditionGroup

Kondisi memberi tahu Analytics data apa yang harus disertakan atau dikecualikan dari segmen.

Representasi JSON
{
  "conditionScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Kolom
conditionScoping

enum (UserCriteriaScoping)

Data disertakan atau dikecualikan dari segmen berdasarkan apakah data tersebut cocok dengan grup kondisi. Cakupan ini menentukan berapa banyak peristiwa yang dievaluasi oleh segmentFilterExpression sebelum grup kondisi ditentukan sebagai cocok atau tidak. Misalnya, jika conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, ekspresi dievaluasi pada semua peristiwa dalam sebuah sesi, lalu grup kondisi ditentukan akan cocok atau tidak untuk pengguna ini. Misalnya, jika conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, ekspresi dievaluasi pada satu peristiwa, lalu grup kondisi ditentukan sebagai cocok atau tidak untuk pengguna ini.

Opsional. Jika tidak ditentukan, conditionScoping = ACROSS_ALL_SESSIONS akan digunakan.

segmentFilterExpression

object (SegmentFilterExpression)

Data disertakan atau dikecualikan dari segmen berdasarkan apakah data tersebut cocok dengan ekspresi ini. Ekspresi menyatakan kriteria pada dimensi, metrik, dan/atau parameter.

UserCriteriaScoping

Cakupan menentukan peristiwa mana yang dipertimbangkan saat mengevaluasi apakah pengguna memenuhi kriteria.

Enum
USER_CRITERIA_SCOPING_UNSPECIFIED Cakupan kriteria tidak ditentukan. Jangan tentukan.
USER_CRITERIA_WITHIN_SAME_EVENT Jika kriteria terpenuhi dalam satu peristiwa, pengguna akan cocok dengan kriteria.
USER_CRITERIA_WITHIN_SAME_SESSION Jika kriteria terpenuhi dalam satu sesi, pengguna cocok dengan kriteria.
USER_CRITERIA_ACROSS_ALL_SESSIONS Jika kriteria terpenuhi oleh peristiwa apa pun untuk pengguna, pengguna akan cocok dengan kriteria tersebut.

SegmentFilterExpression

Menunjukkan kombinasi filter segmen.

Representasi JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentFilterExpressionList)
  },
  "orGroup": {
    object (SegmentFilterExpressionList)
  },
  "notExpression": {
    object (SegmentFilterExpression)
  },
  "segmentFilter": {
    object (SegmentFilter)
  },
  "segmentEventFilter": {
    object (SegmentEventFilter)
  }
  // End of list of possible types for union field expr.
}
Kolom
Kolom union expr. Tentukan satu jenis filter untuk SegmentFilterExpression. expr hanya dapat berupa salah satu dari berikut:
andGroup

object (SegmentFilterExpressionList)

SegmentFilterEkspresiion di andGroup memiliki hubungan DAN.

orGroup

object (SegmentFilterExpressionList)

SegmentFilterEkspresiion di orGroup memiliki hubungan ATAU.

notExpression

object (SegmentFilterExpression)

SegmentFilterEkspresiion BUKAN dari notExpression.

segmentFilter

object (SegmentFilter)

Filter segmen primitif.

segmentEventFilter

object (SegmentEventFilter)

Membuat filter yang cocok dengan peristiwa dari satu nama peristiwa. Jika ekspresi filter parameter ditentukan, hanya subkumpulan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter yang cocok dengan filter peristiwa ini.

SegmentFilterExpressionList

Daftar ekspresi filter segmen.

Representasi JSON
{
  "expressions": [
    {
      object (SegmentFilterExpression)
    }
  ]
}
Kolom
expressions[]

object (SegmentFilterExpression)

Daftar ekspresi filter segmen

SegmentFilter

Ekspresi untuk memfilter nilai dimensi atau metrik.

Representasi JSON
{
  "fieldName": string,
  "filterScoping": {
    object (SegmentFilterScoping)
  },

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Kolom
fieldName

string

Nama dimensi atau nama metrik.

filterScoping

object (SegmentFilterScoping)

Menentukan cakupan filter.

Kolom union one_filter. Tentukan satu jenis filter untuk Filter. one_filter hanya dapat berupa salah satu dari berikut:
stringFilter

object (StringFilter)

Filter terkait string.

inListFilter

object (InListFilter)

Filter untuk nilai dalam daftar.

numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.

betweenFilter

object (BetweenFilter)

Filter untuk antara dua nilai.

SegmentFilterScoping

Cakupan menentukan bagaimana dimensi & metrik beberapa peristiwa harus dipertimbangkan saat mengevaluasi filter segmen.

Representasi JSON
{
  "atAnyPointInTime": boolean
}
Kolom
atAnyPointInTime

boolean

Jika atAnyPointInTime bernilai benar, filter ini akan bernilai benar untuk semua peristiwa jika bernilai benar untuk peristiwa apa pun dalam rentang tanggal permintaan.

Parameter atAnyPointInTime ini tidak memperluas rentang tanggal peristiwa dalam laporan. Jika atAnyPointInTime bernilai benar, hanya peristiwa dalam rentang tanggal laporan yang dipertimbangkan saat mengevaluasi filter ini.

atAnyPointInTime ini hanya dapat ditentukan jika cakupan kriteria adalah ACROSS_ALL_SESSIONS dan tidak dapat ditentukan secara berurutan.

Jika cakupan kriteria adalah ACROSS_ALL_SESSIONS, atAnyPointInTime = false akan digunakan jika tidak ditentukan.

SegmentEventFilter

Membuat filter yang cocok dengan peristiwa dari satu nama peristiwa. Jika ekspresi filter parameter ditentukan, hanya subkumpulan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter yang cocok dengan filter peristiwa ini.

Representasi JSON
{
  "eventName": string,
  "segmentParameterFilterExpression": {
    object (SegmentParameterFilterExpression)
  }
}
Kolom
eventName

string

Filter ini cocok dengan peristiwa dari satu nama peristiwa ini. Nama peristiwa wajib diisi.

segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

Jika ditentukan, filter ini akan mencocokkan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter.

Di dalam ekspresi filter parameter, hanya filter parameter yang tersedia.

SegmentParameterFilterExpression

Menunjukkan kombinasi filter segmen pada parameter.

Representasi JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "orGroup": {
    object (SegmentParameterFilterExpressionList)
  },
  "notExpression": {
    object (SegmentParameterFilterExpression)
  },
  "segmentParameterFilter": {
    object (SegmentParameterFilter)
  }
  // End of list of possible types for union field expr.
}
Kolom
Kolom union expr. Tentukan satu jenis filter untuk SegmentParameterFilterExpression. expr hanya dapat berupa salah satu dari berikut:
andGroup

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression di andGroup memiliki hubungan DAN.

orGroup

object (SegmentParameterFilterExpressionList)

SegmentParameterFilterExpression di orGroup memiliki hubungan ATAU.

notExpression

object (SegmentParameterFilterExpression)

SegmentParameterFilterExpression BUKAN dari notExpression.

segmentParameterFilter

object (SegmentParameterFilter)

Filter parameter segmen primitif.

SegmentParameterFilterExpressionList

Daftar ekspresi filter parameter segmen.

Representasi JSON
{
  "expressions": [
    {
      object (SegmentParameterFilterExpression)
    }
  ]
}
Kolom
expressions[]

object (SegmentParameterFilterExpression)

Daftar ekspresi filter parameter segmen.

SegmentParameterFilter

Ekspresi untuk memfilter nilai parameter dalam segmen.

Representasi JSON
{
  "filterScoping": {
    object (SegmentParameterFilterScoping)
  },

  // Union field one_parameter can be only one of the following:
  "eventParameterName": string,
  "itemParameterName": string
  // End of list of possible types for union field one_parameter.

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Kolom
filterScoping

object (SegmentParameterFilterScoping)

Menentukan cakupan filter.

Kolom union one_parameter. Kolom yang sedang difilter. one_parameter hanya ada berupa salah satu diantara berikut:
eventParameterName

string

Filter ini akan dievaluasi berdasarkan parameter peristiwa yang ditentukan. Parameter peristiwa dicatat sebagai parameter peristiwa. Parameter peristiwa menyertakan kolom seperti "firebase_screen" & "currency".

Parameter peristiwa hanya dapat digunakan dalam segmen & funnel, serta hanya dapat digunakan dalam filter turunan dari EventFilter. Dalam filter turunan dari EventFilter, parameter peristiwa atau item harus digunakan.

itemParameterName

string

Filter ini akan dievaluasi pada parameter item yang ditentukan. Parameter item dicatat sebagai parameter dalam array item. Parameter item mencakup kolom seperti "item_name" & "item_category".

Parameter item hanya dapat digunakan dalam segmen & funnel, serta hanya dapat digunakan di filter turunan dari EventFilter. Dalam filter turunan dari EventFilter, parameter peristiwa atau item harus digunakan.

Parameter item hanya tersedia di peristiwa e-commerce. Untuk mempelajari peristiwa e-commerce lebih lanjut, lihat panduan Mengukur e-commerce.

Kolom union one_filter. Tentukan satu jenis filter. one_filter hanya ada berupa salah satu diantara berikut:
stringFilter

object (StringFilter)

Filter terkait string.

inListFilter

object (InListFilter)

Filter untuk nilai dalam daftar.

numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.

betweenFilter

object (BetweenFilter)

Filter untuk antara dua nilai.

SegmentParameterFilterScoping

Cakupan menentukan bagaimana beberapa peristiwa harus dipertimbangkan saat mengevaluasi filter parameter segmen.

Representasi JSON
{
  "inAnyNDayPeriod": string
}
Kolom
inAnyNDayPeriod

string (int64 format)

Mengumpulkan parameter selama periode hari yang ditentukan sebelum menerapkan filter. Hanya didukung jika cakupan kriteria adalah ACROSS_ALL_SESSIONS atau WITHIN_SAME_SESSION. Hanya didukung jika parameternya adalah event_count.

Misalnya, jika inAnyNDayPeriod adalah 3, eventName adalah "purchase", parameter peristiwanya adalah "event_count", dan kriteria Filter lebih besar dari 5, filter ini akan mengakumulasi jumlah peristiwa pembelian selama setiap periode 3 hari berturut-turut dalam rentang tanggal laporan; pengguna akan meneruskan kriteria Filter ini untuk disertakan dalam segmen ini jika jumlah peristiwa pembeliannya melebihi 5 dalam periode 3 hari berturut-turut. Misalnya, periode 01-11-2021 hingga 03-11-2021, 02-11-2021 hingga 04-11-2021, 03-11-2021 hingga 05-11-2021, dan lain-lain akan dipertimbangkan.

Rentang tanggal tidak diperpanjang dengan tujuan memiliki jendela N hari penuh di dekat awal rentang tanggal. Misalnya, jika laporan ditujukan untuk 01-11-2021 hingga 10-11-2021 dan inAnyNDayPeriod = 3, periode dua hari pertama akan dipersingkat secara efektif karena tidak ada data peristiwa di luar rentang tanggal laporan yang akan dibaca. Misalnya, empat periode pertama secara efektif adalah: 01-11-2021 hingga 01-11-2021, 01-11-2021 hingga 02-11-2021, 01-11-2021 hingga 03-11-2021, dan 01-11-2021 hingga 01-11-2021

inAnyNDayPeriod bersifat opsional. Jika tidak ditentukan, segmentParameterFilter akan diterapkan satu per satu ke setiap peristiwa.

UserSegmentSequenceGroup

Tentukan kondisi yang harus terjadi dalam urutan tertentu agar pengguna menjadi anggota segmen.

Representasi JSON
{
  "sequenceScoping": enum (UserCriteriaScoping),
  "sequenceMaximumDuration": string,
  "userSequenceSteps": [
    {
      object (UserSequenceStep)
    }
  ]
}
Kolom
sequenceScoping

enum (UserCriteriaScoping)

Semua langkah urutan harus dipenuhi dalam pencakupan agar pengguna cocok dengan urutan. Misalnya jika sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, semua langkah urutan harus selesai dalam satu sesi agar pengguna cocok dengan urutan. sequenceScoping = USER_CRITERIA_WITHIN_SAME_EVENT tidak didukung.

Opsional. Jika tidak ditentukan, conditionScoping = ACROSS_ALL_SESSIONS akan digunakan.

sequenceMaximumDuration

string (Duration format)

Menentukan jangka waktu saat seluruh urutan harus terjadi; misalnya, 30 Menit. sequenceMaximumDuration mencakup endpoint pada perincian mikrodetik. Misalnya, urutan dengan durasi maksimum 5 detik dapat diselesaikan pada 4,9 atau 5,0 detik, tetapi tidak 5 detik dan 1 mikrodetik.

sequenceMaximumDuration bersifat opsional, dan jika tidak ditentukan, urutan dapat diselesaikan dalam durasi kapan pun.

Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

userSequenceSteps[]

object (UserSequenceStep)

Urutan langkah kondisi yang diurutkan. Peristiwa pengguna harus menyelesaikan setiap langkah agar pengguna tersebut cocok dengan UserSegmentSequenceGroup.

UserSequenceStep

Kondisi yang harus terjadi dalam urutan langkah yang ditentukan agar pengguna ini cocok dengan urutan.

Representasi JSON
{
  "isDirectlyFollowedBy": boolean,
  "stepScoping": enum (UserCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Kolom
isDirectlyFollowedBy

boolean

Jika benar, peristiwa yang memenuhi langkah ini harus berupa peristiwa berikutnya setelah peristiwa yang memenuhi langkah terakhir. Jika false, langkah ini secara tidak langsung akan mengikuti langkah sebelumnya. Misalnya, mungkin ada peristiwa antara langkah sebelumnya dan langkah ini. isDirectlyFollowedBy harus bernilai salah untuk langkah pertama.

stepScoping

enum (UserCriteriaScoping)

Langkah urutan ini harus dipenuhi dalam pencakupan agar pengguna cocok dengan urutan. Misalnya jika sequenceScoping = WITHIN_SAME_SESSION, langkah-langkah urutan ini harus selesai dalam satu sesi agar pengguna mencocokkan urutan. stepScoping = ACROSS_ALL_SESSIONS hanya diizinkan jika sequenceScoping = ACROSS_ALL_SESSIONS.

Opsional. Jika tidak ditentukan, stepScoping akan menggunakan UserCriteriaScoping yang sama seperti sequenceScoping.

segmentFilterExpression

object (SegmentFilterExpression)

Pengguna cocok dengan langkah urutan ini jika peristiwanya cocok dengan ekspresi ini. Ekspresi menyatakan kriteria pada dimensi, metrik, dan/atau parameter.

UserSegmentExclusion

Menentukan pengguna yang dikecualikan dalam segmen ini.

Representasi JSON
{
  "userExclusionDuration": enum (UserExclusionDuration),
  "userExclusionCriteria": {
    object (UserSegmentCriteria)
  }
}
Kolom
userExclusionDuration

enum (UserExclusionDuration)

Menentukan berapa lama pengecualian akan berlaku jika pengguna cocok dengan userExclusionCriteria.

Opsional. Jika tidak ditentukan, userExclusionDuration dari USER_EXCLUSION_TEMPORARY akan digunakan.

userExclusionCriteria

object (UserSegmentCriteria)

Jika pengguna memenuhi ketentuan ini, pengguna tersebut akan dikecualikan dari keanggotaan segmen untuk userExclusionDuration.

UserExclusionDuration

Menghitung opsi berapa lama pengecualian akan berlangsung jika pengguna cocok dengan userExclusionCriteria.

Enum
USER_EXCLUSION_DURATION_UNSPECIFIED Durasi pengecualian tidak ditentukan. Jangan tentukan.
USER_EXCLUSION_TEMPORARY Kecualikan pengguna untuk sementara dari segmen selama periode saat pengguna memenuhi kondisi userExclusionCriteria.
USER_EXCLUSION_PERMANENT Mengecualikan pengguna secara permanen dari segmen jika pengguna memenuhi kondisi userExclusionCriteria.

SessionSegment

Segmen sesi adalah subkumpulan sesi yang terjadi di situs atau aplikasi Anda: misalnya, semua sesi yang berasal dari kampanye iklan tertentu.

Representasi JSON
{
  "sessionInclusionCriteria": {
    object (SessionSegmentCriteria)
  },
  "exclusion": {
    object (SessionSegmentExclusion)
  }
}
Kolom
sessionInclusionCriteria

object (SessionSegmentCriteria)

Menentukan sesi yang disertakan dalam segmen ini. Opsional.

exclusion

object (SessionSegmentExclusion)

Menentukan sesi mana yang dikecualikan dalam segmen ini. Opsional.

SessionSegmentCriteria

Sesi cocok dengan kriteria jika peristiwa sesi memenuhi kondisi dalam kriteria.

Representasi JSON
{
  "andConditionGroups": [
    {
      object (SessionSegmentConditionGroup)
    }
  ]
}
Kolom
andConditionGroups[]

object (SessionSegmentConditionGroup)

Sesi cocok dengan kriteria ini jika sesi cocok dengan masing-masing andConditionGroups ini.

SessionSegmentConditionGroup

Kondisi memberi tahu Analytics data apa yang harus disertakan atau dikecualikan dari segmen.

Representasi JSON
{
  "conditionScoping": enum (SessionCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Kolom
conditionScoping

enum (SessionCriteriaScoping)

Data disertakan atau dikecualikan dari segmen berdasarkan apakah data tersebut cocok dengan grup kondisi. Cakupan ini menentukan berapa banyak peristiwa yang dievaluasi oleh segmentFilterExpression sebelum grup kondisi ditentukan sebagai cocok atau tidak. Misalnya, jika conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, ekspresi dievaluasi pada semua peristiwa dalam sebuah sesi, lalu grup kondisi ditentukan akan cocok atau tidak untuk sesi ini. Misalnya, jika conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, ekspresi dievaluasi pada satu peristiwa, lalu grup kondisi ditentukan akan cocok atau tidak untuk sesi ini.

Opsional. Jika tidak ditentukan, conditionScoping dari WITHIN_SAME_SESSION akan digunakan.

segmentFilterExpression

object (SegmentFilterExpression)

Data disertakan atau dikecualikan dari segmen berdasarkan apakah data tersebut cocok dengan ekspresi ini. Ekspresi menyatakan kriteria pada dimensi, metrik, dan/atau parameter.

SessionCriteriaScoping

Cakupan menentukan peristiwa mana yang dipertimbangkan saat mengevaluasi apakah sebuah sesi memenuhi kriteria.

Enum
SESSION_CRITERIA_SCOPING_UNSPECIFIED Cakupan kriteria tidak ditentukan. Jangan tentukan.
SESSION_CRITERIA_WITHIN_SAME_EVENT Jika kriteria terpenuhi dalam satu peristiwa, sesi cocok dengan kriteria.
SESSION_CRITERIA_WITHIN_SAME_SESSION Jika kriteria terpenuhi dalam satu sesi, sesi tersebut cocok dengan kriteria.

SessionSegmentExclusion

Menentukan sesi mana yang dikecualikan dalam segmen ini.

Representasi JSON
{
  "sessionExclusionDuration": enum (SessionExclusionDuration),
  "sessionExclusionCriteria": {
    object (SessionSegmentCriteria)
  }
}
Kolom
sessionExclusionDuration

enum (SessionExclusionDuration)

Menentukan berapa lama pengecualian akan berlangsung jika sesi cocok dengan sessionExclusionCriteria.

Opsional. Jika tidak ditentukan, sessionExclusionDuration dari SESSION_EXCLUSION_TEMPORARY akan digunakan.

sessionExclusionCriteria

object (SessionSegmentCriteria)

Jika sesi memenuhi ketentuan ini, sesi tersebut akan dikecualikan dari keanggotaan segmen untuk sessionExclusionDuration.

SessionExclusionDuration

Menghitung opsi berapa lama pengecualian akan berlangsung jika sesi cocok dengan sessionExclusionCriteria.

Enum
SESSION_EXCLUSION_DURATION_UNSPECIFIED Durasi pengecualian tidak ditentukan. Jangan tentukan.
SESSION_EXCLUSION_TEMPORARY Kecualikan sesi dari segmen untuk sementara selama periode saat sesi memenuhi kondisi sessionExclusionCriteria.
SESSION_EXCLUSION_PERMANENT Mengecualikan sesi secara permanen dari segmen jika sesi memenuhi kondisi sessionExclusionCriteria.

EventSegment

Segmen peristiwa adalah subkumpulan peristiwa yang dipicu di situs atau aplikasi Anda, misalnya, semua peristiwa pembelian yang dilakukan di lokasi tertentu; peristiwa app_exception yang terjadi di sistem operasi tertentu.

Representasi JSON
{
  "eventInclusionCriteria": {
    object (EventSegmentCriteria)
  },
  "exclusion": {
    object (EventSegmentExclusion)
  }
}
Kolom
eventInclusionCriteria

object (EventSegmentCriteria)

Menentukan peristiwa yang disertakan dalam segmen ini. Opsional.

exclusion

object (EventSegmentExclusion)

Menentukan peristiwa mana yang dikecualikan dalam segmen ini. Opsional.

EventSegmentCriteria

Peristiwa cocok dengan kriteria jika peristiwa tersebut memenuhi kondisi dalam kriteria.

Representasi JSON
{
  "andConditionGroups": [
    {
      object (EventSegmentConditionGroup)
    }
  ]
}
Kolom
andConditionGroups[]

object (EventSegmentConditionGroup)

Peristiwa cocok dengan kriteria ini jika peristiwa cocok dengan setiap andConditionGroups ini.

EventSegmentConditionGroup

Kondisi memberi tahu Analytics data apa yang harus disertakan atau dikecualikan dari segmen.

Representasi JSON
{
  "conditionScoping": enum (EventCriteriaScoping),
  "segmentFilterExpression": {
    object (SegmentFilterExpression)
  }
}
Kolom
conditionScoping

enum (EventCriteriaScoping)

conditionScoping harus selalu EVENT_CRITERIA_WITHIN_SAME_EVENT.

Opsional. Jika tidak ditentukan, conditionScoping dari EVENT_CRITERIA_WITHIN_SAME_EVENT akan digunakan.

segmentFilterExpression

object (SegmentFilterExpression)

Data disertakan atau dikecualikan dari segmen berdasarkan apakah data tersebut cocok dengan ekspresi ini. Ekspresi menyatakan kriteria pada dimensi, metrik, dan/atau parameter.

EventCriteriaScoping

Cakupan menentukan peristiwa mana yang dipertimbangkan ketika mengevaluasi apakah suatu peristiwa memenuhi kriteria.

Enum
EVENT_CRITERIA_SCOPING_UNSPECIFIED Cakupan kriteria tidak ditentukan. Jangan tentukan.
EVENT_CRITERIA_WITHIN_SAME_EVENT Jika kriteria terpenuhi dalam satu peristiwa, peristiwa tersebut cocok dengan kriteria.

EventSegmentExclusion

Menentukan peristiwa mana yang dikecualikan dalam segmen ini.

Representasi JSON
{
  "eventExclusionDuration": enum (EventExclusionDuration),
  "eventExclusionCriteria": {
    object (EventSegmentCriteria)
  }
}
Kolom
eventExclusionDuration

enum (EventExclusionDuration)

eventExclusionDuration harus selalu PERMANENTLY_EXCLUDE.

Opsional. Jika tidak ditentukan, eventExclusionDuration dari EVENT_EXCLUSION_PERMANENT akan digunakan.

eventExclusionCriteria

object (EventSegmentCriteria)

Jika sebuah peristiwa memenuhi kondisi ini, peristiwa tersebut akan dikecualikan dari keanggotaan segmen untuk eventExclusionDuration.

EventExclusionDuration

Menghitung opsi berapa lama pengecualian akan berlangsung jika peristiwa cocok dengan eventExclusionCriteria.

Enum
EVENT_EXCLUSION_DURATION_UNSPECIFIED Durasi pengecualian tidak ditentukan. Jangan tentukan.
EVENT_EXCLUSION_PERMANENT Mengecualikan peristiwa dari segmen secara permanen jika peristiwa tersebut memenuhi kondisi eventExclusionCriteria.

FilterExpression

Untuk menampilkan filter dimensi atau metrik. Kolom dalam FilterExpression yang sama harus berupa semua dimensi atau metrik.

Representasi JSON
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (FilterExpressionList)
  },
  "orGroup": {
    object (FilterExpressionList)
  },
  "notExpression": {
    object (FilterExpression)
  },
  "filter": {
    object (Filter)
  }
  // End of list of possible types for union field expr.
}
Kolom
Kolom union expr. Tentukan satu jenis ekspresi filter untuk FilterExpression. expr hanya dapat berupa salah satu dari berikut:
andGroup

object (FilterExpressionList)

FilterEkspresi dalam andGroup memiliki hubungan DAN.

orGroup

object (FilterExpressionList)

Ekspresi Filter di orGroup memiliki hubungan ATAU.

notExpression

object (FilterExpression)

FilterEkspresi BUKAN dari Ekspresi.

filter

object (Filter)

Filter primitif. Dalam FilterExpression yang sama, semua nama kolom filter harus berupa semua dimensi atau metrik.

FilterExpressionList

Daftar ekspresi filter.

Representasi JSON
{
  "expressions": [
    {
      object (FilterExpression)
    }
  ]
}
Kolom
expressions[]

object (FilterExpression)

Daftar ekspresi filter.

Filter

Ekspresi untuk memfilter nilai dimensi atau metrik.

Representasi JSON
{
  "fieldName": string,

  // Union field one_filter can be only one of the following:
  "stringFilter": {
    object (StringFilter)
  },
  "inListFilter": {
    object (InListFilter)
  },
  "numericFilter": {
    object (NumericFilter)
  },
  "betweenFilter": {
    object (BetweenFilter)
  }
  // End of list of possible types for union field one_filter.
}
Kolom
fieldName

string

Nama dimensi atau nama metrik. Harus berupa nama yang ditentukan dalam dimensi atau metrik.

Kolom union one_filter. Tentukan satu jenis filter untuk Filter. one_filter hanya dapat berupa salah satu dari berikut:
stringFilter

object (StringFilter)

Filter terkait string.

inListFilter

object (InListFilter)

Filter untuk nilai dalam daftar.

numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.

betweenFilter

object (BetweenFilter)

Filter untuk antara dua nilai.

FunnelSubReport

Sublaporan funnel berisi nilai data dimensi dan metrik. Misalnya, 12 pengguna mencapai langkah kedua funnel.

Representasi JSON
{
  "dimensionHeaders": [
    {
      object (DimensionHeader)
    }
  ],
  "metricHeaders": [
    {
      object (MetricHeader)
    }
  ],
  "rows": [
    {
      object (Row)
    }
  ],
  "metadata": {
    object (FunnelResponseMetadata)
  }
}
Kolom
dimensionHeaders[]

object (DimensionHeader)

Menjelaskan kolom dimensi. Laporan funnel selalu menyertakan dimensi tahapan funnel dalam respons sublaporan. Dimensi tambahan seperti perincian, tanggal, dan tindakan berikutnya mungkin ada dalam respons jika diminta.

metricHeaders[]

object (MetricHeader)

Menjelaskan kolom metrik. Laporan funnel selalu menyertakan pengguna aktif dalam respons sub-laporan. Tabel funnel menyertakan metrik tambahan seperti rasio penyelesaian, pengabaian, dan rasio pengabaian.

rows[]

object (Row)

Baris kombinasi nilai dimensi dan nilai metrik dalam laporan.

metadata

object (FunnelResponseMetadata)

Metadata untuk laporan funnel.

DimensionHeader

Menjelaskan kolom dimensi dalam laporan. Dimensi yang diminta dalam laporan menghasilkan entri kolom dalam baris dan DimensionHeaders. Namun, dimensi yang digunakan secara eksklusif dalam filter atau ekspresi tidak menghasilkan kolom dalam laporan. Oleh karena itu, dimensi tersebut tidak menghasilkan header.

Representasi JSON
{
  "name": string
}
Kolom
name

string

Nama dimensi.

MetricHeader

Menjelaskan kolom metrik dalam laporan. Metrik yang terlihat yang diminta dalam laporan menghasilkan entri kolom dalam baris dan MetricHeaders. Namun, metrik yang digunakan secara eksklusif dalam filter atau ekspresi tidak menghasilkan kolom dalam laporan. Demikian pula, metrik tersebut tidak menghasilkan header.

Representasi JSON
{
  "name": string,
  "type": enum (MetricType)
}
Kolom
name

string

Nama metrik.

type

enum (MetricType)

Jenis data metrik.

MetricType

Jenis nilai metrik.

Enum
METRIC_TYPE_UNSPECIFIED Jenis tidak ditentukan.
TYPE_INTEGER Jenis bilangan bulat.
TYPE_FLOAT Jenis floating point.
TYPE_SECONDS Durasi detik; jenis floating point khusus.
TYPE_MILLISECONDS Durasi dalam milidetik; jenis floating point khusus.
TYPE_MINUTES Durasi dalam menit; jenis floating point khusus.
TYPE_HOURS Durasi dalam jam; jenis floating point khusus.
TYPE_STANDARD Metrik kustom jenis standar; jenis floating point khusus.
TYPE_CURRENCY Jumlah uang; jenis floating point khusus.
TYPE_FEET Panjang dalam kaki; jenis floating point khusus.
TYPE_MILES Panjang dalam mil; jenis floating point khusus.
TYPE_METERS Panjang dalam meter; jenis floating point khusus.
TYPE_KILOMETERS Panjang dalam kilometer; jenis floating point khusus.

Baris

Data laporan untuk setiap baris. Misalnya jika RunReportRequest berisi:

"dimensions": [
  {
    "name": "eventName"
  },
  {
    "name": "countryId"
  }
],
"metrics": [
  {
    "name": "eventCount"
  }
]

Satu baris dengan 'in_app_purchase' sebagai eventName, 'JP' sebagai countryId, dan 15 sebagai eventCount, adalah:

"dimensionValues": [
  {
    "value": "in_app_purchase"
  },
  {
    "value": "JP"
  }
],
"metricValues": [
  {
    "value": "15"
  }
]
Representasi JSON
{
  "dimensionValues": [
    {
      object (DimensionValue)
    }
  ],
  "metricValues": [
    {
      object (MetricValue)
    }
  ]
}
Kolom
dimensionValues[]

object (DimensionValue)

Daftar nilai dimensi yang diminta. Di PivotReport, dimensionsValues hanya dicantumkan untuk dimensi yang disertakan dalam pivot.

metricValues[]

object (MetricValue)

Daftar nilai metrik yang terlihat dan diminta.

DimensionValue

Nilai dimensi.

Representasi JSON
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Kolom
Kolom union one_value. Satu jenis nilai dimensi one_value hanya dapat berupa salah satu dari yang berikut:
value

string

Nilai sebagai string jika jenis dimensinya adalah string.

MetricValue

Nilai metrik.

Representasi JSON
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
Kolom
Kolom union one_value. Salah satu dari nilai metrik one_value hanya dapat berupa salah satu dari yang berikut:
value

string

Nilai pengukuran. Lihat MetricHeader untuk jenis.

FunnelResponseMetadata

Metadata respons laporan funnel berisi informasi tambahan tentang laporan funnel.

Representasi JSON
{
  "samplingMetadatas": [
    {
      object (SamplingMetadata)
    }
  ]
}
Kolom
samplingMetadatas[]

object (SamplingMetadata)

Jika hasil laporan funnel diambil sampelnya, hal ini menjelaskan berapa persentase peristiwa yang digunakan dalam laporan funnel ini. Satu samplingMetadatas diisi untuk setiap rentang tanggal. Setiap samplingMetadatas sesuai dengan rentang tanggal sesuai urutan rentang tanggal yang ditentukan dalam permintaan.

Namun, jika hasil tidak diambil sampelnya, kolom ini tidak akan ditentukan.

SamplingMetadata

Jika hasil laporan funnel diambil sampelnya, metadata ini menjelaskan persentase peristiwa yang digunakan dalam laporan funnel ini untuk rentang tanggal tertentu. Pengambilan sampel adalah praktik menganalisis {i>subset<i} dari semua data untuk mengungkap informasi yang berarti pada {i>dataset<i} yang lebih besar.

Representasi JSON
{
  "samplesReadCount": string,
  "samplingSpaceSize": string
}
Kolom
samplesReadCount

string (int64 format)

Total jumlah peristiwa yang dibaca dalam sampel laporan ini untuk rentang tanggal. Ini adalah ukuran subkumpulan data properti ini yang dianalisis dalam laporan funnel ini.

samplingSpaceSize

string (int64 format)

Jumlah total peristiwa yang ada dalam data properti ini yang dapat dianalisis dalam laporan funnel ini untuk rentang tanggal tertentu. Pengambilan sampel mengungkap informasi yang berarti tentang set data yang lebih besar, dan ini adalah ukuran set data yang lebih besar.

Untuk menghitung persentase data yang tersedia yang digunakan dalam laporan funnel ini, hitung samplesReadCount/samplingSpaceSize.

PropertyQuota

Status saat ini dari semua kuota untuk Properti Analytics ini. Jika kuota untuk properti habis, semua permintaan ke properti tersebut akan menampilkan error Resource Habis.

Representasi JSON
{
  "tokensPerDay": {
    object (QuotaStatus)
  },
  "tokensPerHour": {
    object (QuotaStatus)
  },
  "concurrentRequests": {
    object (QuotaStatus)
  },
  "serverErrorsPerProjectPerHour": {
    object (QuotaStatus)
  },
  "potentiallyThresholdedRequestsPerHour": {
    object (QuotaStatus)
  },
  "tokensPerProjectPerHour": {
    object (QuotaStatus)
  }
}
Kolom
tokensPerDay

object (QuotaStatus)

Properti Analytics Standar dapat menggunakan hingga 200.000 token per hari; Properti Analytics 360 dapat menggunakan 2.000.000 token per hari. Sebagian besar permintaan menggunakan kurang dari 10 token.

tokensPerHour

object (QuotaStatus)

Properti Analytics Standar dapat menggunakan hingga 40.000 token per jam; Properti Analytics 360 dapat menggunakan 400.000 token per jam. Permintaan API menggunakan satu token, dan jumlah tersebut dipotong dari semua kuota per jam, harian, dan per project.

concurrentRequests

object (QuotaStatus)

Properti Analytics Standar dapat mengirim maksimal 10 permintaan serentak; Properti Analytics 360 dapat menggunakan maksimal 50 permintaan serentak.

serverErrorsPerProjectPerHour

object (QuotaStatus)

Properti Analytics Standar dan pasangan project cloud dapat memiliki hingga 10 error server per jam; Properti Analytics 360 dan pasangan project cloud dapat memiliki hingga 50 error server per jam.

potentiallyThresholdedRequestsPerHour

object (QuotaStatus)

Properti Analytics dapat mengirim hingga 120 permintaan dengan dimensi yang berpotensi mencapai nilai minimum per jam. Dalam permintaan batch, setiap permintaan laporan dihitung satu per satu untuk kuota ini jika permintaan berisi dimensi yang berpotensi mencapai nilai minimum.

tokensPerProjectPerHour

object (QuotaStatus)

Properti Analytics dapat menggunakan hingga 35% token per project per jam. Jumlah ini, Properti Analytics standar dapat menggunakan hingga 14.000 token per project per jam, dan Properti Analytics 360 dapat menggunakan 140.000 token per project per jam. Permintaan API menggunakan satu token, dan jumlah tersebut dipotong dari semua kuota per jam, harian, dan per project.

QuotaStatus

Status saat ini untuk grup kuota tertentu.

Representasi JSON
{
  "consumed": integer,
  "remaining": integer
}
Kolom
consumed

integer

Kuota yang digunakan oleh permintaan ini.

remaining

integer

Sisa kuota setelah permintaan ini.