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

Chỉ có đầu ra. Tên tài nguyên cho tài nguyên về Đối tượng này. Định dạng: thuộc tính/{propertyId}/audiences/{audienceId}

string

Bắt buộc. Tên hiển thị của Đối tượng.

string

Bắt buộc. Nội dung mô tả về Đối tượng.

integer

Bắt buộc. Bất biến. Khoảng thời gian mà một người dùng thuộc Đối tượng. Bạn không được đặt khoảng thời gian này quá 540 ngày.

boolean

Chỉ có đầu ra. Giá trị này sẽ tự động được GA đặt thành false nếu đây là một Đối tượng quảng cáo không được cá nhân hoá và bị loại trừ khỏi hoạt động cá nhân hoá quảng cáo.

object (AudienceEventTrigger)

Không bắt buộc. Chỉ định một sự kiện để ghi lại khi người dùng tham gia Đối tượng. Nếu bạn không đặt chính sách này, thì hệ thống sẽ không ghi lại sự kiện nào khi người dùng tham gia Đối tượng.

enum (AudienceExclusionDurationMode)

Bất biến. Chỉ định khoảng thời gian áp dụng quy tắc loại trừ cho những người dùng đáp ứng bộ lọc loại trừ. Bộ lọc này được áp dụng cho tất cả mệnh đề bộ lọc EXCLUDE và bị bỏ qua khi không có mệnh đề bộ lọc EXCLUDE trong Đối tượng.

object (AudienceFilterClause)

Bắt buộc. Bất biến. Danh sách không theo thứ tự. Lọc các mệnh đề xác định Đối tượng. Tất cả mệnh đề sẽ kết hợp với nhau.

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo Đối tượng.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".

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

string

Bắt buộc. Tên sự kiện sẽ được ghi lại.

enum (LogCondition)

Bắt buộc. Thời điểm ghi nhật ký sự kiện.

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

Bắt buộc. Chỉ định xem đây là mệnh đề bộ lọc bao gồm hay loại trừ.

object (AudienceSimpleFilter)

Một bộ lọc đơn giản mà người dùng phải đáp ứng để trở thành thành viên của Đối tượng.

object (AudienceSequenceFilter)

Các bộ lọc phải xảy ra theo thứ tự cụ thể để người dùng trở thành thành viên của Đối tượng.

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

enum (AudienceFilterScope)

Bắt buộc. Bất biến. Chỉ định phạm vi cho bộ lọc này.

object (AudienceFilterExpression)

Bắt buộc. Bất biến. Biểu thức logic của bộ lọc sự kiện, chỉ số hoặc phương diện Đối tượng.

{

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

Danh sách biểu thức cần kết hợp AND. Tệp này chỉ có thể chứa AudienceFilterExpressions có orGroup. Bạn phải đặt giá trị này cho AudienceFilterExpression cấp cao nhất.

object (AudienceFilterExpressionList)

Danh sách biểu thức để kết hợp OR. Tệp này không được chứa AudienceFilterExpression với andGroup hoặc orGroup.

object (AudienceFilterExpression)

Biểu thức bộ lọc KHÔNG được phép (Ví dụ: đảo ngược, bổ sung). Chỉ số này chỉ có thể bao gồm phương diệnOrMetricFilter. Bạn không thể đặt giá trị này ở cấp AudienceFilterExpression cấp cao nhất.

object (AudienceDimensionOrMetricFilter)

Bộ lọc trên một phương diện hoặc chỉ số duy nhất. Bạn không thể đặt giá trị này ở cấp AudienceFilterExpression cấp cao nhất.

object (AudienceEventFilter)

Tạo bộ lọc khớp với một sự kiện cụ thể. Bạn không thể đặt giá trị này ở cấp AudienceFilterExpression cấp cao nhất.

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

object (AudienceFilterExpression)

Danh sách các biểu thức lọc Đối tượng.

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

Bắt buộc. Bất biến. Tên phương diện hoặc tên chỉ số cần lọc. Nếu tên trường đề cập đến một phương diện hoặc chỉ số tuỳ chỉnh, thì tiền tố phạm vi sẽ được thêm vào phía trước tên phương diện hoặc chỉ số tuỳ chỉnh. Để biết thêm thông tin về tiền tố phạm vi hoặc phương diện/chỉ số tuỳ chỉnh, hãy tham khảo tài liệu về Google Analytics Data API.

boolean

Không bắt buộc. Cho biết bộ lọc này có cần đánh giá động hay không. Nếu bạn đặt chính sách này thành true, thì người dùng sẽ tham gia Đối tượng nếu họ đã từng đáp ứng điều kiện (phương thức đánh giá tĩnh). Nếu bạn không đặt hoặc đặt thành false, thì hoạt động đánh giá của người dùng cho một Đối tượng sẽ diễn ra linh động; người dùng được thêm vào Đối tượng khi đáp ứng các điều kiện và sau đó bị xoá khi không còn đáp ứng các điều kiện đó nữa.

Bạn chỉ có thể đặt chế độ cài đặt này khi phạm vi Đối tượng là ACROSS_ALL_SESSIONS.

integer

Không bắt buộc. Nếu được đặt, hãy chỉ định khoảng thời gian đánh giá dữ liệu theo số ngày. Nếu bạn không đặt chính sách này, thì dữ liệu đối tượng sẽ được đánh giá dựa trên dữ liệu toàn thời gian (Ví dụ: khoảng thời gian vô hạn).

Ví dụ: nếu bạn đặt thành 1 ngày, thì chỉ có dữ liệu của ngày hiện tại mới được đánh giá. Điểm tham chiếu là ngày hiện tại khi atAnyPointInTime chưa được đặt hoặc có giá trị false.

Bạn chỉ có thể đặt phạm vi đối tượng khi phạm vi Đối tượng là ACROSS_ALL_SESSIONS và không được nhiều hơn 60 ngày.

object (StringFilter)

Bộ lọc cho phương diện loại chuỗi khớp với một mẫu cụ thể.

object (InListFilter)

Bộ lọc cho một phương diện chuỗi khớp với một danh sách lựa chọn cụ thể.

object (NumericFilter)

Bộ lọc cho các giá trị số hoặc ngày trên một phương diện hoặc chỉ số.

object (BetweenFilter)

Bộ lọc cho các giá trị số hoặc ngày giữa các giá trị nhất định trên một phương diện hoặc chỉ số.

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

enum (MatchType)

Bắt buộc. Loại đối sánh cho bộ lọc chuỗi.

string

Bắt buộc. Giá trị chuỗi cần so khớp.

boolean

Không bắt buộc. Nếu đúng, kết quả khớp có phân biệt chữ hoa chữ thường. Nếu sai, thì kết quả khớp không phân biệt chữ hoa chữ thường.

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

string

Bắt buộc. Danh sách các giá trị chuỗi có thể dùng để so khớp. Không được để trống.

boolean

Không bắt buộc. Nếu đúng, kết quả khớp có phân biệt chữ hoa chữ thường. Nếu sai, thì kết quả khớp không phân biệt chữ hoa chữ thường.

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

enum (Operation)

Bắt buộc. Toán tử được áp dụng cho bộ lọc số.

object (NumericValue)

Bắt buộc. Giá trị số hoặc ngày tháng để so khớp.

{

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

Giá trị số nguyên.

number

Gấp đôi giá trị.

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

object (NumericValue)

Bắt buộc. Bắt đầu bằng số này.

object (NumericValue)

Bắt buộc. Kết thúc bằng số này.

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

string

Bắt buộc. Bất biến. Tên của sự kiện cần so khớp.

object (AudienceFilterExpression)

Không bắt buộc. Nếu được chỉ định, bộ lọc này sẽ khớp với các sự kiện khớp với cả tên sự kiện và biểu thức lọc thông số. Không thể đặt AudienceEventFilter bên trong biểu thức bộ lọc thông số (Ví dụ: bộ lọc sự kiện lồng nhau không được hỗ trợ). Đây phải là một andGroup ofdimensionOrMetricFilter hoặc notExpression; Không hỗ trợ toán tử AND (VÀ) cho OR. Ngoài ra, nếu bộ lọc này có chứa "eventCount" thì chỉ có bộ lọc đó mới được xem xét; thì tất cả các bộ lọc khác sẽ bị bỏ qua.

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

enum (AudienceFilterScope)

Bắt buộc. Bất biến. Chỉ định phạm vi cho bộ lọc này.

string (Duration format)

Không bắt buộc. Xác định khoảng thời gian mà toàn bộ trình tự phải xảy ra.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

object (AudienceSequenceStep)

Bắt buộc. Trình tự các bước theo thứ tự. Người dùng phải hoàn tất từng bước để tham gia bộ lọc trình tự.

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

enum (AudienceFilterScope)

Bắt buộc. Bất biến. Chỉ định phạm vi cho bước này.

boolean

Không bắt buộc. Nếu đúng, sự kiện thoả mãn bước này phải là sự kiện tiếp theo sau sự kiện đáp ứng bước cuối cùng. Nếu bạn đặt chính sách này thành sai hoặc không đặt, thì bước này gián tiếp đứng sau bước trước đó; ví dụ: có thể có sự kiện giữa bước trước đó và bước này. Thuộc tính này sẽ bị bỏ qua trong bước đầu tiên.

string (Duration format)

Không bắt buộc. Khi thiết lập, bước này phải được đáp ứng trong giới hạn limitedDuration của bước trước (Ví dụ: t[i] – t[i-1] <= ConstrainttDuration). Nếu bạn không đặt chính sách này thì sẽ không có yêu cầu về thời lượng (thời lượng thực sự là không giới hạn). Thuộc tính này sẽ bị bỏ qua trong bước đầu tiên.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, kết thúc bằng "s". Ví dụ: "3.5s".

object (AudienceFilterExpression)

Bắt buộc. Bất biến. Biểu thức logic của bộ lọc sự kiện, chỉ số hoặc phương diện Đối tượng trong mỗi bước.