- Referensi: Audiens
- AudienceEventTrigger
- LogCondition
- AudienceExclusionDurationMode
- AudienceFilterClause
- AudienceSimpleFilter
- AudienceFilterScope
- AudienceFilterExpression
- AudienceFilterExpressionList
- AudienceDimensionOrMetricFilter
- StringFilter
- MatchType
- InListFilter
- NumericFilter
- Operasi
- NumericValue
- BetweenFilter
- AudienceEventFilter
- AudienceSequenceFilter
- AudienceSequenceStep
- AudienceClauseType
- Metode
Referensi: Audiens
Pesan resource yang mewakili Audiens GA4.
Representasi JSON |
---|
{ "name": string, "displayName": string, "description": string, "membershipDurationDays": integer, "adsPersonalizationEnabled": boolean, "eventTrigger": { object ( |
Kolom | |
---|---|
name |
Hanya output. Nama resource untuk resource Audiens ini. Format: properties/{propertyId}/audiences/{audienceId} |
displayName |
Wajib. Nama tampilan Audiens. |
description |
Wajib. Deskripsi Audiens. |
membershipDurationDays |
Wajib. Tidak dapat diubah. Durasi pengguna harus tetap berada di Audiens. Tidak boleh ditetapkan ke lebih dari 540 hari. |
adsPersonalizationEnabled |
Hanya output. Nilai ini secara otomatis ditetapkan oleh GA ke salah (false) jika ini adalah Audiens NPA dan dikecualikan dari personalisasi iklan. |
eventTrigger |
Opsional. Menentukan peristiwa yang akan dicatat saat pengguna bergabung dengan Audiens. Jika tidak ditetapkan, tidak ada peristiwa yang akan dicatat saat pengguna bergabung dengan Audiens. |
exclusionDurationMode |
Tidak dapat diubah. Menentukan durasi pengecualian untuk pengguna yang memenuhi filter pengecualian. Filter ini diterapkan ke semua klausa filter KECUALIKAN dan diabaikan jika tidak ada klausa filter KECUALIKAN dalam Audiens. |
filterClauses[] |
Wajib. Tidak dapat diubah. Daftar yang tidak diurutkan. Klausa filter yang menentukan Audiens. Semua klausa akan digabungkan dengan fungsi AND. |
AudienceEventTrigger
Menentukan peristiwa yang akan dicatat saat pengguna bergabung dengan Audiens.
Representasi JSON |
---|
{
"eventName": string,
"logCondition": enum ( |
Kolom | |
---|---|
eventName |
Wajib. Nama peristiwa yang akan dicatat. |
logCondition |
Wajib. Waktu untuk mencatat peristiwa ke dalam log. |
LogCondition
Menentukan waktu untuk mencatat peristiwa ke dalam log.
Enum | |
---|---|
LOG_CONDITION_UNSPECIFIED |
Kondisi log tidak ditentukan. |
AUDIENCE_JOINED |
Peristiwa hanya boleh dicatat dalam log saat pengguna bergabung. |
AUDIENCE_MEMBERSHIP_RENEWED |
Peristiwa harus dicatat setiap kali kondisi Audiens terpenuhi, meskipun pengguna sudah menjadi anggota Audiens. |
AudienceExclusionDurationMode
Menentukan durasi pengecualian untuk pengguna yang memenuhi filter pengecualian.
Enum | |
---|---|
AUDIENCE_EXCLUSION_DURATION_MODE_UNSPECIFIED |
Tidak ditentukan. |
EXCLUDE_TEMPORARILY |
Kecualikan pengguna dari Audiens selama periode saat mereka memenuhi klausul filter. |
EXCLUDE_PERMANENTLY |
Kecualikan pengguna dari Audiens jika mereka pernah memenuhi klausul filter. |
AudienceFilterClause
Klausa untuk menentukan filter sederhana atau urutan. Filter dapat bersifat inklusif (Misalnya, pengguna yang memenuhi klausa filter akan disertakan dalam Audiens) atau eksklusif (Misalnya, pengguna yang memenuhi klausa filter akan dikecualikan dari Audiens).
Representasi JSON |
---|
{ "clauseType": enum ( |
Kolom | |
---|---|
clauseType |
Wajib. Menentukan apakah ini merupakan klausa filter sertakan atau kecualikan. |
Kolom union
|
|
simpleFilter |
Filter sederhana yang harus dipenuhi pengguna untuk menjadi anggota Audiens. |
sequenceFilter |
Filter yang harus muncul dalam urutan tertentu agar pengguna menjadi anggota Audiens. |
AudienceSimpleFilter
Menentukan filter sederhana yang harus dipenuhi pengguna untuk menjadi anggota Audiens.
Representasi JSON |
---|
{ "scope": enum ( |
Kolom | |
---|---|
scope |
Wajib. Tidak dapat diubah. Menentukan cakupan untuk filter ini. |
filterExpression |
Wajib. Tidak dapat diubah. Ekspresi logis dari dimensi, metrik, atau filter peristiwa Audiens. |
AudienceFilterScope
Menentukan cara mengevaluasi pengguna untuk bergabung dengan Audiens.
Enum | |
---|---|
AUDIENCE_FILTER_SCOPE_UNSPECIFIED |
Cakupan tidak ditentukan. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_EVENT |
Pengguna bergabung dengan Audiens jika kondisi filter terpenuhi dalam satu peristiwa. |
AUDIENCE_FILTER_SCOPE_WITHIN_SAME_SESSION |
Pengguna bergabung dengan Audiens jika kondisi filter terpenuhi dalam satu sesi. |
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS |
Pengguna bergabung dengan Audiens jika kondisi filter terpenuhi oleh peristiwa apa pun di seluruh sesi. |
AudienceFilterExpression
Ekspresi logis dari dimensi, metrik, atau filter peristiwa Audiens.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union expr . Ekspresi yang diterapkan ke filter. expr hanya ada berupa salah satu diantara berikut: |
|
andGroup |
Daftar ekspresi yang akan digabungkan dengan AND. Grup ini hanya dapat berisi AudienceFilterExpressions dengan orGroup. Ini harus ditetapkan untuk AudienceFilterExpression tingkat atas. |
orGroup |
Daftar ekspresi untuk OR yang digabungkan. Grup tidak boleh berisi AudienceFilterExpressions dengan andGroup atau orGroup. |
notExpression |
Ekspresi filter yang akan DIBUKA (Misalnya, dibalik, dilengkapi). Fungsi ini hanya dapat berisi dimensiOrMetricFilter. Ini tidak dapat ditetapkan pada AudienceFilterExpression tingkat atas. |
dimensionOrMetricFilter |
Filter pada satu dimensi atau metrik. Ini tidak dapat ditetapkan pada AudienceFilterExpression tingkat atas. |
eventFilter |
Membuat filter yang cocok dengan peristiwa tertentu. Ini tidak dapat ditetapkan pada AudienceFilterExpression tingkat atas. |
AudienceFilterExpressionList
Daftar ekspresi filter Audiens.
Representasi JSON |
---|
{
"filterExpressions": [
{
object ( |
Kolom | |
---|---|
filterExpressions[] |
Daftar ekspresi filter Audiens. |
AudienceDimensionOrMetricFilter
Filter spesifik untuk dimensi atau metrik tunggal.
Representasi JSON |
---|
{ "fieldName": string, "atAnyPointInTime": boolean, "inAnyNDayPeriod": integer, // Union field |
Kolom | |
---|---|
fieldName |
Wajib. Tidak dapat diubah. Nama dimensi atau nama metrik yang akan difilter. Jika nama kolom merujuk ke dimensi atau metrik kustom, awalan cakupan akan ditambahkan di bagian depan nama dimensi atau metrik kustom. Untuk informasi selengkapnya tentang awalan cakupan atau dimensi/metrik kustom, lihat dokumentasi Google Analytics Data API. |
atAnyPointInTime |
Opsional. Menunjukkan apakah filter ini memerlukan evaluasi dinamis atau tidak. Jika ditetapkan ke benar (true), pengguna akan bergabung dengan Audiens jika pernah memenuhi kondisi (evaluasi statis). Jika tidak disetel atau disetel ke salah (false), evaluasi pengguna untuk Audiens bersifat dinamis; pengguna ditambahkan ke Audiens saat memenuhi kondisi, lalu dihapus saat tidak lagi memenuhinya. Ini hanya dapat ditetapkan jika Cakupan audiens adalah ACROSS_ALL_SESSIONS. |
inAnyNDayPeriod |
Opsional. Jika ditetapkan, menentukan periode waktu untuk mengevaluasi data dalam jumlah hari. Jika tidak ditetapkan, data audiens akan dievaluasi berdasarkan data sepanjang waktu (Misalnya, jangka waktu tak terbatas). Misalnya, jika ditetapkan ke 1 hari, hanya data hari ini yang akan dievaluasi. Titik referensinya adalah hari ini saat atAnyPointInTime tidak disetel atau salah. Ini hanya dapat ditetapkan jika Cakupan audiens adalah ACROSS_ALL_SESSIONS dan tidak boleh lebih dari 60 hari. |
Kolom union one_filter . Salah satu filter di atas. one_filter hanya ada berupa salah satu diantara berikut: |
|
stringFilter |
Filter untuk dimensi jenis string yang cocok dengan pola tertentu. |
inListFilter |
Filter untuk dimensi string yang cocok dengan daftar opsi tertentu. |
numericFilter |
Filter untuk nilai numerik atau tanggal pada dimensi atau metrik. |
betweenFilter |
Filter untuk nilai numerik atau tanggal di antara nilai tertentu pada dimensi atau metrik. |
StringFilter
Filter untuk dimensi jenis string yang cocok dengan pola tertentu.
Representasi JSON |
---|
{
"matchType": enum ( |
Kolom | |
---|---|
matchType |
Wajib. Jenis pencocokan untuk filter string. |
value |
Wajib. Nilai string yang akan dicocokkan. |
caseSensitive |
Opsional. Jika true (benar), kecocokan peka huruf besar/kecil. Jika nilainya adalah salah, pencocokan tidak peka huruf besar/kecil. |
MatchType
Jenis pencocokan untuk 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 |
Ekspresi reguler lengkap cocok dengan nilai string. |
InListFilter
Filter untuk dimensi string yang cocok dengan daftar opsi tertentu.
Representasi JSON |
---|
{ "values": [ string ], "caseSensitive": boolean } |
Kolom | |
---|---|
values[] |
Wajib. Daftar kemungkinan nilai string yang akan dicocokkan. Tidak boleh kosong. |
caseSensitive |
Opsional. Jika true (benar), kecocokan peka huruf besar/kecil. Jika nilainya adalah salah, pencocokan tidak peka huruf besar/kecil. |
NumericFilter
Filter untuk nilai numerik atau tanggal pada dimensi atau metrik.
Representasi JSON |
---|
{ "operation": enum ( |
Kolom | |
---|---|
operation |
Wajib. Operasi yang diterapkan ke filter numerik. |
value |
Wajib. Nilai numerik atau tanggal yang akan dicocokkan. |
Operasi
Operasi yang diterapkan ke filter numerik.
Enum | |
---|---|
OPERATION_UNSPECIFIED |
Tidak ditentukan. |
EQUAL |
Sama. |
LESS_THAN |
Kurang dari. |
GREATER_THAN |
Lebih dari. |
NumericValue
Untuk mewakili angka.
Representasi JSON |
---|
{ // Union field |
Kolom | |
---|---|
Kolom union one_value . Salah satu dari nilai numerik. one_value hanya ada berupa salah satu diantara berikut: |
|
int64Value |
Nilai bilangan bulat. |
doubleValue |
Nilai ganda. |
BetweenFilter
Filter untuk nilai numerik atau tanggal di antara nilai tertentu pada dimensi atau metrik.
Representasi JSON |
---|
{ "fromValue": { object ( |
Kolom | |
---|---|
fromValue |
Wajib. Dimulai dengan angka ini, inklusif. |
toValue |
Wajib. Berakhir dengan angka ini, inklusif. |
AudienceEventFilter
Filter yang cocok dengan peristiwa dari satu nama peristiwa. Jika parameter peristiwa ditentukan, hanya subkumpulan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter yang cocok dengan filter peristiwa ini.
Representasi JSON |
---|
{
"eventName": string,
"eventParameterFilterExpression": {
object ( |
Kolom | |
---|---|
eventName |
Wajib. Tidak dapat diubah. Nama peristiwa yang akan dicocokkan. |
eventParameterFilterExpression |
Opsional. Jika ditentukan, filter ini akan mencocokkan peristiwa yang cocok dengan nama peristiwa tunggal dan ekspresi filter parameter. AudienceEventFilter di dalam ekspresi filter parameter tidak dapat ditetapkan (Misalnya, filter peristiwa bertingkat tidak didukung). Ini harus berupa satu andGroup dimensiOrMetricFilter atau notExpression; AND untuk OR tidak didukung. Selain itu, jika menyertakan filter untuk "eventCount", hanya filter tersebut yang akan dipertimbangkan; semua filter lainnya akan diabaikan. |
AudienceSequenceFilter
Menentukan filter yang harus terjadi dalam urutan tertentu agar pengguna menjadi anggota Audiens.
Representasi JSON |
---|
{ "scope": enum ( |
Kolom | |
---|---|
scope |
Wajib. Tidak dapat diubah. Menentukan cakupan untuk filter ini. |
sequenceMaximumDuration |
Opsional. Menentukan jangka waktu saat seluruh urutan harus terjadi. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
sequenceSteps[] |
Wajib. Urutan langkah-langkah yang berurutan. Pengguna harus menyelesaikan setiap langkah untuk bergabung dengan filter urutan. |
AudienceSequenceStep
Kondisi yang harus terjadi dalam urutan langkah yang ditentukan agar pengguna ini cocok dengan urutan.
Representasi JSON |
---|
{ "scope": enum ( |
Kolom | |
---|---|
scope |
Wajib. Tidak dapat diubah. Menentukan cakupan untuk langkah ini. |
immediatelyFollows |
Opsional. Jika true (benar), peristiwa yang memenuhi langkah ini harus berupa peristiwa berikutnya setelah peristiwa yang memenuhi langkah terakhir. Jika tidak disetel atau disetel ke salah (false), langkah ini secara tidak langsung akan mengikuti langkah sebelumnya. Misalnya, mungkin ada peristiwa antara langkah sebelumnya dan langkah ini. Atribut ini diabaikan untuk langkah pertama. |
constraintDuration |
Opsional. Ketika ditetapkan, langkah ini harus dipenuhi dalam constraintDuration dari langkah sebelumnya (Misalnya, t[i] - t[i-1] <= constraintDuration). Jika tidak disetel, tidak ada persyaratan durasi (durasi efektif tidak terbatas). Atribut ini diabaikan untuk langkah pertama. Durasi dalam detik dengan paling banyak sembilan digit pecahan, yang diakhiri dengan ' |
filterExpression |
Wajib. Tidak dapat diubah. Ekspresi logis dari dimensi, metrik, atau filter peristiwa Audiens di setiap langkah. |
AudienceClauseType
Menentukan apakah ini merupakan klausa filter sertakan atau kecualikan.
Enum | |
---|---|
AUDIENCE_CLAUSE_TYPE_UNSPECIFIED |
Jenis klausa tidak ditentukan. |
INCLUDE |
Pengguna akan disertakan dalam Audiens jika klausa filter terpenuhi. |
EXCLUDE |
Pengguna akan dikecualikan dari Audiens jika klausa filter terpenuhi. |
Metode |
|
---|---|
|
Mengarsipkan Audiens di properti. |
|
Membuat Audiens. |
|
Cari satu Audiens. |
|
Mencantumkan Audiens di properti. |
|
Memperbarui Audiens di properti. |