Method: properties.runFunnelReport

Menampilkan laporan funnel yang disesuaikan dari data peristiwa Google Analytics Anda. Data yang ditampilkan dari API ini adalah 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 menyempurnakan 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. Isi Masukan Pelaporan Funnel Google Analytics Data API untuk memberikan masukan tentang API ini.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
property

string

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 
{
  "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)

Rentang tanggal data untuk 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 disertakan dalam baris respons untuk kedua rentang tanggal tersebut.
funnel

object (Funnel)

Konfigurasi funnel permintaan ini. Konfigurasi funnel ini diperlukan.
funnelBreakdown

object (FunnelBreakdown)

Jika ditentukan, perincian ini menambahkan dimensi ke respons sublaporan tabel funnel. Dimensi perincian ini memperluas setiap tahapan funnel ke nilai unik dimensi perincian. Misalnya, pengelompokan menurut dimensi deviceCategory akan membuat baris untuk mobile, tablet, desktop, dan total.
funnelNextAction

object (FunnelNextAction)

Jika ditentukan, tindakan berikutnya akan menambahkan dimensi ke respons sublaporan visualisasi funnel. Dimensi tindakan berikutnya ini memperluas setiap langkah funnel ke nilai unik tindakan berikutnya. Misalnya, tindakan dimensi eventName berikutnya akan membuat baris untuk beberapa peristiwa (yaitu session_start & click) dan total.

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

enum (FunnelVisualizationType)

Jenis visualisasi funnel mengontrol dimensi yang ada dalam respons sublaporan visualisasi funnel. Jika tidak ditentukan, STANDARD_FUNNEL akan digunakan.
segments[]

object (Segment)

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)

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. limit harus positif.

API juga dapat menampilkan lebih sedikit baris daripada limit yang diminta, jika tidak ada jumlah nilai dimensi sebanyak limit.
dimensionFilter

object (FilterExpression)

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

boolean

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

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

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

object (FunnelSubReport)

Tabel funnel adalah laporan dengan langkah 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 dengan langkah funnel, segmen, tanggal, dimensi 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 untuk pesan ini. kind 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

RentangTanggal

Serangkaian 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 dalam hal ini, tanggal disimpulkan 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 dalam hal ini, tanggal disimpulkan berdasarkan zona waktu pelaporan properti.
name

string

Menetapkan nama untuk rentang tanggal ini. Dimensi dateRange bernilai nama ini dalam respons laporan. Jika ditetapkan, tidak boleh diawali dengan date_range_ atau RESERVED_. Jika tidak disetel, rentang tanggal akan diberi nama berdasarkan 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 menyempurnakan 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 dalam funnel tertutup, pengguna harus memasuki funnel pada langkah pertama. Opsional. Jika tidak ditentukan, funnel tertutup akan digunakan.
steps[]

object (FunnelStep)

Langkah-langkah berurutan dari funnel ini.

LangkahFunnel

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 yang unik untuk langkah ini. Jika tidak ditentukan, langkah tersebut akan diberi nama berdasarkan nama terindeks berbasis 1 (yaitu "0. ", "1. ", dll.). Nama ini menentukan nilai string yang ditampilkan oleh dimensi funnelStepName. Misalnya, menentukan name = Purchase dalam langkah funnel ketiga permintaan akan menghasilkan 3. Purchase dalam respons laporan funnel.
isDirectlyFollowedBy

boolean

Jika benar, langkah ini harus langsung mengikuti langkah sebelumnya. Jika salah, mungkin ada peristiwa antara langkah sebelumnya dan langkah ini. Jika tidak ditentukan, isDirectlyFollowedBy akan diperlakukan sebagai 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 tersebut. withinDurationFromPriorStep sudah termasuk 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 menurut durasi waktu.

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

FunnelFilterExpression

Mengekspresikan 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)

FunnelFilterExpression di andGroup memiliki hubungan AND.
orGroup

object (FunnelFilterExpressionList)

FunnelFilterExpression di orGroup memiliki hubungan OR.
notExpression

object (FunnelFilterExpression)

FunnelFilterExpression 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.

DaftarFunnelExpressExpression

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 dapat berupa salah satu dari berikut:
stringFilter

object (StringFilter)

Filter terkait string.
inListFilter

object (InListFilter)

Filter untuk nilai daftar.
numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.
betweenFilter

object (BetweenFilter)

Filter antara dua nilai.

StringString

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 benar, nilai string peka huruf besar/kecil.

Jenis Kecocokan

Jenis pencocokan filter string

Enumerasi
MATCH_TYPE_UNSPECIFIED Belum ditetapkan
EXACT Pencocokan persis untuk nilai string.
BEGINS_WITH Diawali dengan nilai string.
ENDS_WITH Diakhiri dengan nilai string.
CONTAINS Berisi nilai string.
FULL_REGEXP Pencocokan penuh untuk ekspresi reguler dengan nilai string.
PARTIAL_REGEXP Kecocokan parsial untuk ekspresi reguler dengan nilai string.

DalamDaftarFilter

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 benar, nilai string peka huruf besar/kecil.

NomorFilter

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

Enumerasi
OPERATION_UNSPECIFIED Tidak ditentukan.
EQUAL Setara
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

NilaiNumerik

Untuk merepresentasikan 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 nilai numerik one_value hanya dapat berupa salah satu dari berikut:
int64Value

string (int64 format)

Nilai bilangan bulat
doubleValue

number

Nilai ganda

Di AntaraFilter

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

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

object (NumericValue)

Diawali dengan nomor ini.
toValue

object (NumericValue)

Diakhiri dengan nomor ini.

FunnelPeristiwaFilter

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 nama peristiwa tunggal ini. Nama peristiwa wajib diisi.
funnelParameterFilterExpression

object (FunnelParameterFilterExpression)

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

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

FunnelParameterFilterExpression

Mengekspresikan 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)

FunnelParameterFilterExpression di andGroup memiliki hubungan AND.
orGroup

object (FunnelParameterFilterExpressionList)

FunnelParameterFilterExpression di orGroup memiliki hubungan ATAU.
notExpression

object (FunnelParameterFilterExpression)

FunnelParameterFilterExpression 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 dalam 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 dapat berupa salah satu dari berikut:
eventParameterName

string

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

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

string

Filter ini akan dievaluasi sesuai 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 di segmen & funnel dan 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 dapat berupa salah satu dari berikut:
stringFilter

object (StringFilter)

Filter terkait string.
inListFilter

object (InListFilter)

Filter untuk nilai daftar.
numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.
betweenFilter

object (BetweenFilter)

Filter antara dua nilai.

Perincian Funnel

Perincian menambahkan dimensi ke respons sublaporan tabel funnel.

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

object (Dimension)

Kolom dimensi ditambahkan ke respons sublaporan tabel funnel. Dimensi perincian menguraikan 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. Batas harus melampaui nol dan tidak boleh lebih dari 15.

Dimensi

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

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

string

Nama dimensi. Lihat Dimensi API untuk daftar nama dimensi.

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 direferensikan oleh name di dimensionFilter, orderBys, dimensionExpression, dan pivots.
dimensionExpression

object (DimensionExpression)

Satu dimensi dapat menjadi hasil dari ekspresi beberapa dimensi. Misalnya, dimensi "negara, kota": concatenate(negara, ", ", kota).

Ekspresi Ekspres

Digunakan untuk mengekspresikan dimensi yang merupakan hasil dari formula beberapa dimensi. Contoh penggunaan: 1) huruf kecil(dimensi) 2) menyambung(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 ke huruf besar.
concatenate

object (ConcatenateExpression)

Digunakan untuk menggabungkan nilai dimensi menjadi satu dimensi. Misalnya, dimensi "negara, kota": concatenate(negara, ", ", kota).

KasusEkspresi

Digunakan untuk mengonversi nilai dimensi ke satu kasus.

Representasi JSON 
{
  "dimensionName": string
}
Kolom
dimensionName

string

Nama dimensi. Nama harus merujuk kembali pada nama di kolom dimensi permintaan.

ConcatenateExpression

Digunakan untuk menggabungkan nilai dimensi menjadi satu dimensi.

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

string

Nama dimensi. Nama harus merujuk kembali ke nama dalam kolom dimensi permintaan.
delimiter

string

Pembatas ditempatkan di antara nama dimensi.

Pemisah biasanya berupa karakter tunggal seperti "|" atau "," tetapi dapat berupa string yang lebih panjang. Jika nilai dimensi berisi pemisah, keduanya akan ada sebagai respons tanpa perbedaan. Misalnya, jika dimensi 1 nilai = "AS,FR", dimensi 2 nilai = "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 langkah funnel i akan menampilkan peristiwa pertama setelah peristiwa yang memenuhi syarat pengguna ke langkah funnel i, tetapi sebelum pengguna mencapai langkah funnel i+1.

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

object (Dimension)

Kolom dimensi ditambahkan ke respons sublaporan visualisasi funnel. Dimensi tindakan berikutnya menampilkan nilai dimensi berikutnya dari dimensi ini setelah pengguna mencapai langkah funnel 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. Batas harus melampaui nol dan tidak boleh lebih dari 5.

Jenis Visualisasi Funnel

Mengontrol dimensi yang ada dalam respons sublaporan visualisasi funnel.

Enumerasi
FUNNEL_VISUALIZATION_TYPE_UNSPECIFIED Jenis tidak ditentukan.
STANDARD_FUNNEL Funnel standar (berlangkah). Sublaporan visualisasi funnel dalam respons tidak akan berisi tanggal.
TRENDED_FUNNEL Funnel yang sedang 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 menentukan nama segmen dengan nomor indeks berbasis 1 dari segmen dalam permintaan (yaitu "1. Segmen", "2. Segmen", dll.).
Kolom union one_segment_scope. Segmen ditentukan dalam satu cakupan. one_segment_scope hanya dapat berupa salah satu dari 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.

SegmenPengguna

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

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

object (UserSegmentCriteria)

Menentukan pengguna mana yang disertakan dalam segmen ini. Opsional.
exclusion

object (UserSegmentExclusion)

Menentukan pengguna yang dikecualikan dalam segmen ini. Opsional.

Kriteria SegmenPengguna

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 cocok dengan masing-masing andConditionGroups dan andSequenceGroups. andConditionGroups mungkin kosong jika andSequenceGroups ditentukan.
andSequenceGroups[]

object (UserSegmentSequenceGroup)

Pengguna cocok dengan kriteria ini jika cocok dengan masing-masing andSequenceGroups dan andConditionGroups. andSequenceGroups mungkin kosong jika andConditionGroups ditentukan.

GrupSegmenSegmenPengguna

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 kecocokannya dengan grup kondisi. Cakupan ini menentukan jumlah peristiwa yang dievaluasi segmentFilterExpression sebelum grup kondisi ditentukan untuk dicocokkan atau tidak. Misalnya, jika conditionScoping = USER_CRITERIA_WITHIN_SAME_SESSION, ekspresi dievaluasi pada semua peristiwa di sesi, lalu, grup kondisi ditentukan untuk dicocokkan atau tidak untuk pengguna ini. Misalnya, jika conditionScoping = USER_CRITERIA_WITHIN_SAME_EVENT, ekspresi dievaluasi pada satu peristiwa, lalu grup kondisi ditentukan untuk dicocokkan 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 kecocokannya dengan ekspresi ini. Ekspresi mengekspresikan kriteria pada dimensi, metrik, dan/atau parameter.

Cakupan Kriteria Pengguna

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

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

SegmenFilterExpression

Mengekspresikan 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)

SegmenFilterExpression di andGroup memiliki hubungan AND.
orGroup

object (SegmentFilterExpressionList)

SegmenFilterExpression di orGroup memiliki hubungan OR.
notExpression

object (SegmentFilterExpression)

SegmenFilterExpression 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.

SegmenFilterExpressionList

Daftar ekspresi filter segmen.

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

object (SegmentFilterExpression)

Daftar ekspresi filter segmen

SegmenSegmen

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 daftar.
numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.
betweenFilter

object (BetweenFilter)

Filter antara dua nilai.

SegmenFilterScoping

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

Representasi JSON 
{
  "atAnyPointInTime": boolean
}
Kolom
atAnyPointInTime

boolean

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

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

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

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

SegmenPeristiwaFilter

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 nama peristiwa tunggal ini. Nama peristiwa wajib diisi.
segmentParameterFilterExpression

object (SegmentParameterFilterExpression)

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

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

SegmenParameterFilterExpression

Mengekspresikan 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)

SegmenParameterFilterExpression di andGroup memiliki hubungan DAN.
orGroup

object (SegmentParameterFilterExpressionList)

SegmenParameterFilterExpression di orGroup memiliki hubungan ATAU.
notExpression

object (SegmentParameterFilterExpression)

SegmenParameterFilterExpression BUKAN dari notExpression.
segmentParameterFilter

object (SegmentParameterFilter)

Filter parameter segmen primitif.

SegmenParameterFilterExpressionList

Daftar ekspresi filter parameter segmen.

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

object (SegmentParameterFilterExpression)

Daftar ekspresi filter parameter segmen.

SegmenParameterFilter

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 dapat berupa salah satu dari berikut:
eventParameterName

string

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

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

string

Filter ini akan dievaluasi sesuai 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 di segmen & funnel dan 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 dapat berupa salah satu dari berikut:
stringFilter

object (StringFilter)

Filter terkait string.
inListFilter

object (InListFilter)

Filter untuk nilai daftar.
numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.
betweenFilter

object (BetweenFilter)

Filter antara dua nilai.

SegmenParameterFilterScoping

Cakupan menentukan cara 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 peristiwa adalah "event_count", dan kriteria Filter lebih besar dari 5, filter ini akan mengakumulasi jumlah peristiwa pembelian selama setiap 3 hari berturut-turut dalam rentang tanggal laporan jika pengguna memasukkan periode ini sesuai dengan periode pembelian, termasuk 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 periode N hari penuh yang dekat dengan awal rentang tanggal. Misalnya, jika laporan diperuntukkan untuk tanggal 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 akan secara efektif adalah: 01-11-2021 hingga 01-11-2021, 01-11-11-2021 hingga 01-11-2021, 01-11-2021 hingga 01-11-2021, dan 01-11-10-2021 hingga 01-01-2021 dan 01-10-2021 hingga 01-20-1-2021.

inAnyNDayPeriod bersifat opsional. Jika tidak ditentukan, segmentParameterFilter akan diterapkan ke setiap peristiwa secara individual.

SegmenSegmenPengguna

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

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

enum (UserCriteriaScoping)

Semua langkah urutan harus terpenuhi dalam pencakupan agar pengguna mencocokkan urutannya. Misalnya jika sequenceScoping = USER_CRITERIA_WITHIN_SAME_SESSION, semua langkah urutan harus diselesaikan 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 periode waktu saat keseluruhan urutan harus terjadi; misalnya, 30 Menit. sequenceMaximumDuration sudah termasuk endpoint pada perincian mikrodetik. Misalnya, urutan dengan durasi maksimum 5 detik dapat diselesaikan dalam 4,9 atau 5,0 detik, tetapi tidak dalam 5 detik dan 1 mikrodetik.

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

Durasi dalam detik dengan hingga sembilan digit pecahan, diakhiri dengan 's'. Contoh: "3.5s".
userSequenceSteps[]

object (UserSequenceStep)

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

LangkahUrutanPengguna

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

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

boolean

Jika benar, peristiwa yang memenuhi langkah ini harus menjadi peristiwa berikutnya setelah peristiwa memenuhi langkah terakhir. Jika salah, langkah ini secara tidak langsung mengikuti langkah sebelumnya; misalnya, mungkin ada peristiwa di antara langkah sebelumnya dan langkah ini. isDirectlyFollowedBy harus salah untuk langkah pertama.
stepScoping

enum (UserCriteriaScoping)

Langkah urutan ini harus dipenuhi sesuai cakupan agar pengguna dapat mencocokkan urutan. Misalnya, jika sequenceScoping = WITHIN_SAME_SESSION, langkah urutan ini harus diselesaikan dalam satu sesi agar pengguna cocok dengan urutan. stepScoping = ACROSS_ALL_SESSIONS hanya diizinkan jika sequenceScoping = ACROSS_ALL_SESSIONS.

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

object (SegmentFilterExpression)

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

Pengecualian SegmenPengguna

Menentukan pengguna yang dikecualikan di segmen ini.

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

enum (UserExclusionDuration)

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

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

object (UserSegmentCriteria)

Jika memenuhi kondisi ini, pengguna akan dikecualikan dari keanggotaan dalam segmen userExclusionDuration.

DurasiPengecualianPengguna

Menghitung opsi durasi durasi pengecualian jika pengguna cocok dengan userExclusionCriteria.

Enumerasi
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 Kecualikan pengguna secara permanen dari segmen jika pengguna pernah memenuhi kondisi userExclusionCriteria.

SegmenSesi

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 yang dikecualikan di segmen ini. Opsional.

Kriteria SegmenSegmen

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 tiap andConditionGroups.

SessionSectionConditionGroup

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 kecocokannya dengan grup kondisi. Cakupan ini menentukan jumlah peristiwa yang dievaluasi segmentFilterExpression sebelum grup kondisi ditentukan untuk dicocokkan atau tidak. Misalnya, jika conditionScoping = SESSION_CRITERIA_WITHIN_SAME_SESSION, ekspresi dievaluasi pada semua peristiwa dalam sesi, lalu grup kondisi ditentukan untuk dicocokkan atau tidak untuk sesi ini. Misalnya, jika conditionScoping = SESSION_CRITERIA_WITHIN_SAME_EVENT, ekspresi dievaluasi pada satu peristiwa, lalu grup kondisi ditentukan untuk dicocokkan atau tidak untuk sesi ini.

Opsional. Jika tidak ditentukan, conditionScoping sebesar WITHIN_SAME_SESSION akan digunakan.
segmentFilterExpression

object (SegmentFilterExpression)

Data disertakan atau dikecualikan dari segmen berdasarkan kecocokannya dengan ekspresi ini. Ekspresi mengekspresikan kriteria pada dimensi, metrik, dan/atau parameter.

CakupanKriteria Sesi

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

Enumerasi
SESSION_CRITERIA_SCOPING_UNSPECIFIED Cakupan kriteria yang tidak ditentukan. Jangan tentukan.
SESSION_CRITERIA_WITHIN_SAME_EVENT Jika kriteria terpenuhi dalam satu peristiwa, sesi akan cocok dengan kriteria.
SESSION_CRITERIA_WITHIN_SAME_SESSION Jika kriteria terpenuhi dalam satu sesi, sesi akan cocok dengan kriteria.

Pengecualian Segmen Sesi

Menentukan sesi yang dikecualikan di 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 sebesar SESSION_EXCLUSION_TEMPORARY akan digunakan.
sessionExclusionCriteria

object (SessionSegmentCriteria)

Jika sesi memenuhi kondisi ini, sesi tersebut dikecualikan dari keanggotaan dalam segmen untuk sessionExclusionDuration.

Durasi Pengecualian Sesi

Menghitung opsi durasi durasi pengecualian jika sesi cocok dengan sessionExclusionCriteria.

Enumerasi
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 Kecualikan sesi secara permanen dari segmen jika sesi pernah memenuhi kondisi sessionExclusionCriteria.

SegmenPeristiwa

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 yang dikecualikan di segmen ini. Opsional.

Kriteria SegmenSegmen

Peristiwa cocok dengan kriteria jika peristiwa memenuhi kondisi dalam kriteria.

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

object (EventSegmentConditionGroup)

Peristiwa cocok dengan kriteria ini jika peristiwa cocok dengan masing-masing andConditionGroups ini.

EventSegmenConditionGroup

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 sebesar EVENT_CRITERIA_WITHIN_SAME_EVENT akan digunakan.
segmentFilterExpression

object (SegmentFilterExpression)

Data disertakan atau dikecualikan dari segmen berdasarkan kecocokannya dengan ekspresi ini. Ekspresi mengekspresikan kriteria pada dimensi, metrik, dan/atau parameter.

Cakupan EventKriteria

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

Enumerasi
EVENT_CRITERIA_SCOPING_UNSPECIFIED Cakupan kriteria yang tidak ditentukan. Jangan tentukan.
EVENT_CRITERIA_WITHIN_SAME_EVENT Jika kriteria terpenuhi dalam satu peristiwa, maka peristiwa cocok dengan kriteria.

Pengecualian SegmenSegmen

Menentukan peristiwa mana yang dikecualikan di 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 suatu peristiwa memenuhi kondisi ini, peristiwa tersebut akan dikecualikan dari keanggotaan dalam segmen untuk eventExclusionDuration.

Durasi Pengecualian

Menghitung opsi durasi berlangsungnya pengecualian jika peristiwa cocok dengan eventExclusionCriteria.

Enumerasi
EVENT_EXCLUSION_DURATION_UNSPECIFIED Durasi pengecualian tidak ditentukan. Jangan tentukan.
EVENT_EXCLUSION_PERMANENT Kecualikan peristiwa secara permanen dari segmen jika peristiwa pernah memenuhi kondisi eventExclusionCriteria.

FilterEkspresi

Untuk mengekspresikan filter dimensi atau metrik. Kolom di FilterExpression yang sama harus berupa semua dimensi atau semua 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)

FilterExpressions di andGroup memiliki hubungan AND.
orGroup

object (FilterExpressionList)

FilterExpressions di orGroup memiliki hubungan OR.
notExpression

object (FilterExpression)

FilterExpression BUKAN dari notExpression.
filter

object (Filter)

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

DaftarFilterExpression

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 daftar.
numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal.
betweenFilter

object (BetweenFilter)

Filter antara dua nilai.

FunnelSubLaporan

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 di respons sublaporan. Dimensi tambahan seperti pengelompokan, tanggal, dan tindakan berikutnya dapat muncul dalam respons jika diminta.
metricHeaders[]

object (MetricHeader)

Menjelaskan kolom metrik. Laporan funnel selalu menyertakan pengguna aktif dalam respons sublaporan. Tabel funnel mencakup 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.

Header Dimensi

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; juga, dimensi tersebut tidak menghasilkan header.

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Nama dimensi.

Header Metrik

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 di dalam filter atau ekspresi tidak menghasilkan kolom dalam laporan; juga, metrik tersebut tidak menghasilkan header.

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

string

Nama metrik.
type

enum (MetricType)

Jenis data metrik.

Jenis Metrik

Jenis nilai metrik.

Enumerasi
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 dari jenis standar; jenis floating point khusus.
TYPE_CURRENCY Jumlah uang; jenis floating point khusus.
TYPE_FEET Panjang 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, akan menjadi:

"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. Dalam PivotReport, dimensionValues hanya dicantumkan untuk dimensi yang disertakan dalam pivot.
metricValues[]

object (MetricValue)

Daftar nilai metrik terlihat yang diminta.

NilaiDimensi

Nilai dimensi.

Representasi JSON 
{
  "value": string
}
Kolom
value

string

Nilai sebagai string jika jenis dimensi adalah string.

NilaiMetrik

Nilai metrik.

Representasi JSON 
{
  "value": string
}
Kolom
value

string

Nilai pengukuran. Lihat MetricHeader untuk mengetahui jenisnya.

MetadataRespons

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, laporan ini menjelaskan persentase peristiwa yang digunakan dalam laporan funnel ini. Satu samplingMetadatas diisi untuk setiap rentang tanggal. Setiap samplingMetadatas sesuai dengan rentang tanggal untuk menentukan rentang tanggal yang ditentukan dalam permintaan.

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

Pengambilan SampelMetadata

Jika hasil laporan funnel diambil sampelnya, metadata ini menjelaskan persentase peristiwa yang digunakan dalam laporan funnel ini untuk rentang tanggal. Pengambilan sampel adalah praktik dalam menganalisis subset dari semua data untuk mengungkap informasi penting pada set data yang lebih besar.

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

string (int64 format)

Jumlah total peristiwa yang dibaca dalam laporan sampel ini untuk rentang tanggal. Ini adalah ukuran subkumpulan data properti ini yang dianalisis di laporan funnel ini.
samplingSpaceSize

string (int64 format)

Jumlah total peristiwa yang ada di data properti ini yang dapat dianalisis dalam laporan funnel ini untuk rentang tanggal tertentu. Pengambilan sampel mengungkap informasi penting 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.

KuotaProperti

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

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 25.000 token per hari; Properti Analytics 360 dapat menggunakan 250.000 token per hari. Sebagian besar permintaan menggunakan kurang dari 10 token.
tokensPerHour

object (QuotaStatus)

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

object (QuotaStatus)

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

object (QuotaStatus)

Pasangan Properti Analytics standar dan 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 terkena nilai minimum per jam. Dalam permintaan batch, setiap permintaan laporan dihitung satu per satu untuk kuota ini jika permintaan berisi dimensi yang berpotensi terkena nilai minimum.
tokensPerProjectPerHour

object (QuotaStatus)

Properti Analytics dapat menggunakan hingga 25% tokennya per project per jam. Jumlah ini untuk Properti Analytics standar dapat menggunakan hingga 1.250 token per project per jam, dan Properti Analytics 360 dapat menggunakan 12.500 token per project per jam. Permintaan API menggunakan satu jumlah token, dan jumlah tersebut dipotong dari semua kuota per jam, harian, dan per project per jam.

StatusKuota

Status saat ini untuk grup kuota tertentu.

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

integer

Kuota yang digunakan oleh permintaan ini.
remaining

integer

Kuota yang tersisa setelah permintaan ini.