REST Resource: properties.audiences

Resource: Audiens

Pesan resource yang mewakili Audiens.

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "description": string,
  "membershipDurationDays": integer,
  "adsPersonalizationEnabled": boolean,
  "eventTrigger": {
    object (AudienceEventTrigger)
  },
  "exclusionDurationMode": enum (AudienceExclusionDurationMode),
  "filterClauses": [
    {
      object (AudienceFilterClause)
    }
  ],
  "createTime": string
}
Kolom
name

string

Hanya output. Nama resource untuk resource Audiens ini. Format: properties/{propertyId}/audiences/{audienceId}
displayName

string

Wajib. Nama tampilan Audiens.
description

string

Wajib. Deskripsi Audiens.
membershipDurationDays

integer

Wajib. Tidak dapat diubah. Durasi pengguna harus tetap berada dalam Audiens. Durasi tidak boleh lebih dari 540 hari.
adsPersonalizationEnabled

boolean

Hanya output. Nilai ini otomatis ditetapkan oleh GA ke false jika ini adalah Audiens NPA dan dikecualikan dari personalisasi iklan.
eventTrigger

object (AudienceEventTrigger)

Opsional. Menentukan peristiwa yang akan dicatat ke dalam log saat pengguna bergabung dengan Audiens. Jika tidak ditetapkan, tidak ada peristiwa yang dicatat dalam log saat pengguna bergabung dengan Audiens.
exclusionDurationMode

enum (AudienceExclusionDurationMode)

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[]

object (AudienceFilterClause)

Wajib. Tidak dapat diubah. Daftar yang tidak diurutkan. Klausa filter yang menentukan Audiens. Semua klausa akan digabungkan menggunakan fungsi AND.
createTime

string (Timestamp format)

Hanya output. Waktu saat Audiens dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

AudienceEventTrigger

Menentukan peristiwa yang akan dicatat ke dalam log saat pengguna bergabung dengan Audiens.

Representasi JSON 
{
  "eventName": string,
  "logCondition": enum (LogCondition)
}
Kolom
eventName

string

Wajib. Nama peristiwa yang akan dicatat dalam log.
logCondition

enum (LogCondition)

Wajib. Kapan peristiwa dicatat.

LogCondition

Menentukan kapan peristiwa dicatat dalam log.

Enum
LOG_CONDITION_UNSPECIFIED Kondisi log tidak ditentukan.
AUDIENCE_JOINED Peristiwa harus dicatat hanya 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 Mengecualikan pengguna dari Audiens selama periode saat mereka memenuhi klausa filter.
EXCLUDE_PERMANENTLY Mengecualikan pengguna dari Audiens jika mereka pernah memenuhi klausa filter.

AudienceFilterClause

Klausa untuk menentukan filter sederhana atau berurutan. Filter dapat bersifat inklusif (Misalnya, pengguna yang memenuhi klausa filter disertakan dalam Audiens) atau eksklusif (Misalnya, pengguna yang memenuhi klausa filter dikecualikan dari Audiens).

Representasi JSON 
{
  "clauseType": enum (AudienceClauseType),

  // Union field filter can be only one of the following:
  "simpleFilter": {
    object (AudienceSimpleFilter)
  },
  "sequenceFilter": {
    object (AudienceSequenceFilter)
  }
  // End of list of possible types for union field filter.
}
Kolom
clauseType

enum (AudienceClauseType)

Wajib. Menentukan apakah ini adalah klausa filter sertakan atau kecualikan.

Kolom union filter.

filter hanya dapat berupa salah satu dari hal berikut:
simpleFilter

object (AudienceSimpleFilter)

Filter sederhana yang harus dipenuhi pengguna agar menjadi anggota Audiens.
sequenceFilter

object (AudienceSequenceFilter)

Filter yang harus terjadi dalam urutan tertentu agar pengguna menjadi anggota Audiens.

AudienceSimpleFilter

Menentukan filter sederhana yang harus dipenuhi pengguna agar menjadi anggota Audiens.

Representasi JSON 
{
  "scope": enum (AudienceFilterScope),
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}
Kolom
scope

enum (AudienceFilterScope)

Wajib. Tidak dapat diubah. Menentukan cakupan untuk filter ini.
filterExpression

object (AudienceFilterExpression)

Wajib. Tidak dapat diubah. Ekspresi logis dari filter dimensi, metrik, atau 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 ke Audiens jika kondisi filter terpenuhi dalam satu sesi.
AUDIENCE_FILTER_SCOPE_ACROSS_ALL_SESSIONS Pengguna bergabung dengan Audiens jika kondisi filter dipenuhi oleh peristiwa apa pun di seluruh sesi.

AudienceFilterExpression

Ekspresi logis dari filter dimensi, metrik, atau peristiwa Audiens.

Representasi JSON 
{

  // Union field expr can be only one of the following:
  "andGroup": {
    object (AudienceFilterExpressionList)
  },
  "orGroup": {
    object (AudienceFilterExpressionList)
  },
  "notExpression": {
    object (AudienceFilterExpression)
  },
  "dimensionOrMetricFilter": {
    object (AudienceDimensionOrMetricFilter)
  },
  "eventFilter": {
    object (AudienceEventFilter)
  }
  // End of list of possible types for union field expr.
}
Kolom
Kolom union expr. Ekspresi yang diterapkan ke filter. expr hanya dapat berupa salah satu dari berikut:
andGroup

object (AudienceFilterExpressionList)

Daftar ekspresi yang akan di-AND-kan bersama. Hanya dapat berisi AudienceFilterExpressions dengan orGroup. Setelan ini harus ditetapkan untuk AudienceFilterExpression tingkat teratas.
orGroup

object (AudienceFilterExpressionList)

Daftar ekspresi yang akan digabungkan dengan OR. Tidak boleh berisi AudienceFilterExpressions dengan andGroup atau orGroup.
notExpression

object (AudienceFilterExpression)

Ekspresi filter yang akan di-NOT (Misalnya, dibalik, dilengkapi). Hanya dapat menyertakan dimensionOrMetricFilter. Setelan ini tidak dapat ditetapkan di AudienceFilterExpression tingkat teratas.
dimensionOrMetricFilter

object (AudienceDimensionOrMetricFilter)

Filter pada satu dimensi atau metrik. Setelan ini tidak dapat ditetapkan di AudienceFilterExpression tingkat teratas.
eventFilter

object (AudienceEventFilter)

Membuat filter yang cocok dengan peristiwa tertentu. Setelan ini tidak dapat ditetapkan di AudienceFilterExpression tingkat teratas.

AudienceFilterExpressionList

Daftar ekspresi filter Audiens.

Representasi JSON 
{
  "filterExpressions": [
    {
      object (AudienceFilterExpression)
    }
  ]
}
Kolom
filterExpressions[]

object (AudienceFilterExpression)

Daftar ekspresi filter Audiens.

AudienceDimensionOrMetricFilter

Filter tertentu untuk satu dimensi atau metrik.

Representasi JSON 
{
  "fieldName": string,
  "atAnyPointInTime": boolean,
  "inAnyNDayPeriod": integer,

  // 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

Wajib. Tidak dapat diubah. Nama dimensi atau nama metrik yang akan difilter. Jika nama kolom merujuk pada dimensi atau metrik kustom, awalan cakupan akan ditambahkan di depan nama dimensi atau metrik kustom. Untuk mengetahui informasi selengkapnya tentang awalan cakupan atau dimensi/metrik kustom, lihat dokumentasi Google Analytics Data API.
atAnyPointInTime

boolean

Opsional. Menunjukkan apakah filter ini memerlukan evaluasi dinamis atau tidak. Jika disetel ke benar (true), pengguna bergabung ke Audiens jika mereka 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.

Kolom ini hanya dapat ditetapkan jika Cakupan audiens adalah ACROSS_ALL_SESSIONS.
inAnyNDayPeriod

integer

Opsional. Jika disetel, menentukan jangka waktu untuk mengevaluasi data dalam jumlah hari. Jika tidak disetel, data audiens akan dievaluasi berdasarkan data seumur hidup (Misalnya, jangka waktu tak terbatas).

Misalnya, jika ditetapkan ke 1 hari, hanya data hari ini yang dievaluasi. Titik referensinya adalah hari ini jika atAnyPointInTime tidak disetel atau salah.

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

object (StringFilter)

Filter untuk dimensi jenis string yang cocok dengan pola tertentu.
inListFilter

object (InListFilter)

Filter untuk dimensi string yang cocok dengan daftar opsi tertentu.
numericFilter

object (NumericFilter)

Filter untuk nilai numerik atau tanggal pada dimensi atau metrik.
betweenFilter

object (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 (MatchType),
  "value": string,
  "caseSensitive": boolean
}
Kolom
matchType

enum (MatchType)

Wajib. Jenis pencocokan untuk filter string.
value

string

Wajib. Nilai string yang akan dicocokkan.
caseSensitive

boolean

Opsional. Jika benar (true), kecocokan peka huruf besar/kecil. Jika salah, kecocokan tidak peka huruf besar/kecil.

MatchType

Jenis pencocokan untuk filter string.

Enum
MATCH_TYPE_UNSPECIFIED Tidak ditentukan
EXACT Pencocokan persis nilai string.
BEGINS_WITH Dimulai dengan nilai string.
ENDS_WITH Diakhiri 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[]

string

Wajib. Daftar kemungkinan nilai string yang akan dicocokkan. Tidak boleh kosong.
caseSensitive

boolean

Opsional. Jika benar (true), kecocokan peka huruf besar/kecil. Jika salah, kecocokan tidak peka huruf besar/kecil.

NumericFilter

Filter untuk nilai numerik atau tanggal pada dimensi atau metrik.

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

enum (Operation)

Wajib. Operasi yang diterapkan ke filter numerik.
value

object (NumericValue)

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 besar dari.

NumericValue

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.

BetweenFilter

Filter untuk nilai numerik atau tanggal di antara nilai tertentu pada dimensi atau metrik.

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

object (NumericValue)

Wajib. Dimulai dengan angka ini, inklusif.
toValue

object (NumericValue)

Wajib. Berakhir dengan angka ini, inklusif.

AudienceEventFilter

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

Representasi JSON 
{
  "eventName": string,
  "eventParameterFilterExpression": {
    object (AudienceFilterExpression)
  }
}
Kolom
eventName

string

Wajib. Tidak dapat diubah. Nama peristiwa yang akan dicocokkan.
eventParameterFilterExpression

object (AudienceFilterExpression)

Opsional. Jika ditentukan, filter ini 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 dari dimensionOrMetricFilter atau notExpression; AND dari 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 (AudienceFilterScope),
  "sequenceMaximumDuration": string,
  "sequenceSteps": [
    {
      object (AudienceSequenceStep)
    }
  ]
}
Kolom
scope

enum (AudienceFilterScope)

Wajib. Tidak dapat diubah. Menentukan cakupan untuk filter ini.
sequenceMaximumDuration

string (Duration format)

Opsional. Menentukan jangka waktu saat seluruh urutan harus terjadi.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
sequenceSteps[]

object (AudienceSequenceStep)

Wajib. Urutan langkah yang teratur. 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 (AudienceFilterScope),
  "immediatelyFollows": boolean,
  "constraintDuration": string,
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}
Kolom
scope

enum (AudienceFilterScope)

Wajib. Tidak dapat diubah. Menentukan cakupan untuk langkah ini.
immediatelyFollows

boolean

Opsional. Jika benar (true), peristiwa yang memenuhi langkah ini harus menjadi peristiwa berikutnya setelah peristiwa yang memenuhi langkah terakhir. Jika tidak disetel atau salah (false), langkah ini mengikuti langkah sebelumnya secara tidak langsung; misalnya, mungkin ada peristiwa di antara langkah sebelumnya dan langkah ini. Tindakan ini diabaikan untuk langkah pertama.
constraintDuration

string (Duration format)

Opsional. Jika ditetapkan, langkah ini harus dipenuhi dalam constraintDuration langkah sebelumnya (Misalnya, t[i] - t[i-1] <= constraintDuration). Jika tidak ditetapkan, tidak ada persyaratan durasi (durasi tidak terbatas). Tindakan ini diabaikan untuk langkah pertama.

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

object (AudienceFilterExpression)

Wajib. Tidak dapat diubah. Ekspresi logis dari filter dimensi, metrik, atau peristiwa Audiens di setiap langkah.

AudienceClauseType

Menentukan apakah ini adalah 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

archive

 Mengarsipkan Audiens di properti.

create

 Membuat Audiens.

get

 Lookup untuk satu Audiens.

list

 Mencantumkan Audiens di properti.

patch

 Memperbarui Audiens di properti.