REST Resource: properties.audiences

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

string

僅供輸出。這項 Audience 資源的資源名稱。格式：properties/{propertyId}/audiences/{audienceId}

string

必要欄位。目標對象的顯示名稱。

string

必要欄位。目標對象的說明。

integer

必要欄位。不可變動。使用者留在目標對像中的時間長度。不得設為超過 540 天。

boolean

僅供輸出。如果是非個人化廣告目標對象，Google Analytics 會自動將其設為 False，且已從廣告個人化中排除。

object (AudienceEventTrigger)

選用設定。指定要在使用者加入目標對象時記錄的事件。如未設定，使用者加入目標對象時，系統不會記錄任何事件。

enum (AudienceExclusionDurationMode)

不可變動。指定排除條件符合排除篩選器的使用者的保留期限。這個規則會套用至所有 EXCLUDE 篩選器子句，而且如果目標對像中沒有「EXCLUDE」篩選器子句，系統就會忽略這個規則。

object (AudienceFilterClause)

必要欄位。不可變動。未排序的清單。用於定義 Audience 的篩選器子句。所有子句會以 AND 結合在一起。

string (Timestamp format)

僅供輸出。目標對象的建立時間。

RFC3339 世界標準時間「Zulu」的時間戳記格式，解析度為奈秒，且最多 9 個小數位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

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

string

必要欄位。要記錄的事件名稱。

enum (LogCondition)

必要欄位。記錄事件的時間。

{
  "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.
}

enum (AudienceClauseType)

必要欄位。指明這是「包含」或「排除」篩選器子句。

object (AudienceSimpleFilter)

使用者必須符合的簡單篩選器，才會成為目標對象成員。

object (AudienceSequenceFilter)

使用者必須按特定順序觸發，才能成為目標對象成員的篩選器。

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

enum (AudienceFilterScope)

必要欄位。不可變動。指定這個篩選器的範圍。

object (AudienceFilterExpression)

必要欄位。不可變動。用來表示「目標對象」維度、指標或事件篩選器的邏輯運算式。

{

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

object (AudienceFilterExpressionList)

要以 AND 結合的運算式清單。只能包含帶有 orGroup 的 AudienceFilterExpressions。必須在頂層 AudienceFilterExpression 中設定。

object (AudienceFilterExpressionList)

要以 OR 結合的運算式清單。不能包含帶有 andGroup 或 orGroup 的 AudienceFilterExpression。

object (AudienceFilterExpression)

排除的篩選運算式 (例如反轉、互補)。其中只能包含維度 OrMetricFilter。無法在頂層 AudienceFilterExpression 上設定這個項目。

object (AudienceDimensionOrMetricFilter)

篩選單一維度或指標。無法在頂層 AudienceFilterExpression 上設定這個項目。

object (AudienceEventFilter)

建立符合特定事件的篩選器。無法在頂層 AudienceFilterExpression 上設定這個項目。

{
  "filterExpressions": [
    {
      object (AudienceFilterExpression)
    }
  ]
}

object (AudienceFilterExpression)

目標對象篩選運算式清單。

{
  "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.
}

string

必要欄位。不可變動。要篩選的維度名稱或指標名稱。如果欄位名稱是指自訂維度或指標，系統會在自訂維度或指標名稱的前面加上範圍前置字元。如要進一步瞭解範圍前置字元或自訂維度/指標，請參閱 Google Analytics Data API 說明文件。

boolean

選用設定。指出這個篩選器是否需要動態評估。如果設為 true，使用者只要符合條件就會加入目標對象 (靜態評估)。如果未設定或設為 False，系統會動態評估目標對象使用者；使用者滿足條件時，系統就會將他們加進目標對象名單，不再符合條件時則移除。

只有在目標對象範圍為 ACROSS_ALL_SESSIONS 時才能設定這項設定。

integer

選用設定。如果設定，系統會指定評估資料的時間範圍 (以天數為單位)。如未設定，系統會根據生命週期資料 (例如無限時間範圍) 評估目標對象資料。

舉例來說，如果設為 1 天，系統只會評估當天的資料。當 atAnyPointInTime 未設定或為 false 時，參考點即為目前日期。

只有在目標對象範圍為 ACROSS_ALL_SESSIONS 且不得超過 60 天時才能設定。

object (StringFilter)

符合特定模式的字串類型維度篩選器。

object (InListFilter)

與特定選項清單相符的字串維度篩選器。

object (NumericFilter)

篩選維度或指標上的數字或日期值。

object (BetweenFilter)

篩選維度或指標中特定值之間的數字或日期值篩選器。

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

enum (MatchType)

必要欄位。字串篩選器的比對類型。

string

必要欄位。要比對的字串值。

boolean

選用設定。如為 true，則比對會區分大小寫。如果是 false，則比對時不區分大小寫。

{
  "values": [
    string
  ],
  "caseSensitive": boolean
}

string

必要欄位。要比對的可能字串值清單。不得空白。

boolean

選用設定。如為 true，則比對會區分大小寫。如果是 false，則比對時不區分大小寫。

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

enum (Operation)

必要欄位。套用至數值篩選器的作業。

object (NumericValue)

必要欄位。要比對的數值或日期值。

{

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

string (int64 format)

整數值。

number

雙值。

{
  "fromValue": {
    object (NumericValue)
  },
  "toValue": {
    object (NumericValue)
  }
}

object (NumericValue)

必要欄位。以這個數字開頭 (含首尾)。

object (NumericValue)

必要欄位。結尾為這個數字 (含首尾)。

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

string

必要欄位。不可變動。要比對的事件名稱。

object (AudienceFilterExpression)

選用設定。如有指定，此篩選器會比對同時符合單一事件名稱和參數篩選運算式的事件。無法設定參數篩選器運算式中的 AudienceEventFilter (例如不支援巢狀事件篩選器)。應為維度 OrMetricFilter 的單一和群組，或 notExpression；系統不支援 OR 運算子。此外，如果其中包含「eventCount」的篩選器，系統只會採用其中一個。系統會忽略所有其他篩選器

{
  "scope": enum (AudienceFilterScope),
  "sequenceMaximumDuration": string,
  "sequenceSteps": [
    {
      object (AudienceSequenceStep)
    }
  ]
}

enum (AudienceFilterScope)

必要欄位。不可變動。指定這個篩選器的範圍。

string (Duration format)

選用設定。定義必須在整個序列發生的時間範圍。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

object (AudienceSequenceStep)

必要欄位。有順序的步驟。使用者必須完成每個步驟，才能加入序列篩選器。

{
  "scope": enum (AudienceFilterScope),
  "immediatelyFollows": boolean,
  "constraintDuration": string,
  "filterExpression": {
    object (AudienceFilterExpression)
  }
}

enum (AudienceFilterScope)

必要欄位。不可變動。指定這個步驟的範圍。

boolean

選用設定。如果是 true，則滿足此步驟的事件必須是在符合最後一個步驟的事件之後的下一個事件。如果未設定或否，系統會間接遵循前一個步驟；例如先前步驟和這個步驟之間的事件。在第一個步驟中，系統會忽略這個屬性。

string (Duration format)

選用設定。設定後，這個步驟必須在上一個步驟的 constraintDuration 內滿足 (例如 t[i] - t[i-1] <= constraintDuration)。如果不設定，就不需要要求持續時間 (時間實際上沒有限制)。在第一個步驟中，系統會忽略這個屬性。

持續時間以秒為單位，最多 9 個小數位數，結尾為「s」。範例："3.5s"。

object (AudienceFilterExpression)

必要欄位。不可變動。每個步驟中的「目標對象」維度、指標或事件篩選器的邏輯運算式。