UserList

Danh sách người dùng. Đây là danh sách những người dùng mà khách hàng có thể nhắm đến.

Biểu diễn dưới dạng JSON 
{
  "resourceName": string,
  "membershipStatus": enum (UserListMembershipStatus),
  "sizeRangeForDisplay": enum (UserListSizeRange),
  "sizeRangeForSearch": enum (UserListSizeRange),
  "type": enum (UserListType),
  "closingReason": enum (UserListClosingReason),
  "accessReason": enum (AccessReason),
  "accountUserListStatus": enum (UserListAccessStatus),
  "id": string,
  "readOnly": boolean,
  "name": string,
  "description": string,
  "integrationCode": string,
  "membershipLifeSpan": string,
  "sizeForDisplay": string,
  "sizeForSearch": string,
  "eligibleForSearch": boolean,
  "eligibleForDisplay": boolean,
  "matchRatePercentage": integer,

  // Union field user_list can be only one of the following:
  "crmBasedUserList": {
    object (CrmBasedUserListInfo)
  },
  "similarUserList": {
    object (SimilarUserListInfo)
  },
  "ruleBasedUserList": {
    object (RuleBasedUserListInfo)
  },
  "logicalUserList": {
    object (LogicalUserListInfo)
  },
  "basicUserList": {
    object (BasicUserListInfo)
  }
  // End of list of possible types for union field user_list.
}
Trường
resourceName

string

Không thể thay đổi. Tên tài nguyên của danh sách người dùng. Tên tài nguyên trong danh sách người dùng có dạng:

customers/{customerId}/userLists/{userListId}
membershipStatus

enum (UserListMembershipStatus)

Trạng thái thành viên của danh sách người dùng này. Cho biết danh sách người dùng là đang mở hay đang hoạt động. Chỉ những danh sách người dùng đang mở mới có thể tích luỹ nhiều người dùng hơn và có thể được nhắm mục tiêu.
sizeRangeForDisplay

enum (UserListSizeRange)

Chỉ có đầu ra. Phạm vi kích thước xét theo số lượng người dùng trong Danh sách người dùng trên Mạng Hiển thị của Google.

Trường này chỉ để đọc.
type

enum (UserListType)

Chỉ có đầu ra. Loại danh sách này.

Trường này chỉ để đọc.
closingReason

enum (UserListClosingReason)

Cho biết lý do đóng trạng thái thành viên trong danh sách người dùng này. Trạng thái này chỉ được điền sẵn trên những danh sách tự động đóng do không hoạt động và sẽ bị xoá sau khi trạng thái thành viên của danh sách là mở.
accessReason

enum (AccessReason)

Chỉ có đầu ra. Cho biết lý do tài khoản này được cấp quyền truy cập vào danh sách. Lý do có thể là do NỘI DUNG CHIA SẺ, THUỘC QUYỀN SỞ HỮU RIÊNG, ĐÃ CẤP PHÉP hoặc ĐÃ ĐĂNG KÝ.

Trường này chỉ để đọc.
accountUserListStatus

enum (UserListAccessStatus)

Cho biết liệu tính năng chia sẻ này có còn được bật hay không. Khi một Danh sách người dùng được chia sẻ với người dùng, trường này được đặt thành BẬT. Sau đó, chủ sở hữu userList có thể quyết định thu hồi lượt chia sẻ và TẮT lượt chia sẻ đó. Giá trị mặc định của trường này được đặt thành ENABLED.
id

string (int64 format)

Chỉ có đầu ra. Mã của danh sách người dùng.
readOnly

boolean

Chỉ có đầu ra. Một lựa chọn cho biết liệu người dùng có thể chỉnh sửa danh sách hay không. Tuỳ thuộc vào quyền sở hữu danh sách và loại danh sách. Ví dụ: danh sách người dùng tái tiếp thị bên ngoài không thể chỉnh sửa.

Trường này chỉ để đọc.
name

string

Tên của danh sách người dùng này. Tuỳ thuộc vào accessReason, tên danh sách người dùng có thể không phải là duy nhất (ví dụ: nếu accessReason=SHARED)
description

string

Nội dung mô tả về danh sách người dùng này.
integrationCode

string

Mã nhận dạng của hệ thống bên ngoài. Người bán danh sách người dùng sử dụng mã này để liên kết mã nhận dạng trên hệ thống của họ.
membershipLifeSpan

string (int64 format)

Số ngày cookie của người dùng còn trong danh sách của bạn kể từ lần gần đây nhất cookie được thêm vào danh sách. Trường này phải nằm trong khoảng từ 0 đến 540. Tuy nhiên, đối với danh sách người dùng dựa trên CRM, bạn có thể đặt trường này thành 10000, tức là không có thời hạn.

Trường này sẽ bị bỏ qua đối với các loại logicUserList và RuleBasedUserList. Tư cách thành viên trong các loại danh sách này phụ thuộc vào các quy tắc do danh sách xác định.
sizeForDisplay

string (int64 format)

Chỉ có đầu ra. Số lượng người dùng ước tính trong danh sách người dùng này, trên Mạng hiển thị của Google. Giá trị này là rỗng nếu chưa xác định được số lượng người dùng.

Trường này chỉ để đọc.
eligibleForDisplay

boolean

Chỉ có đầu ra. Cho biết danh sách người dùng này đủ điều kiện cho Mạng Hiển thị của Google.

Trường này chỉ để đọc.
matchRatePercentage

integer

Chỉ có đầu ra. Cho biết tỷ lệ khớp của danh sách So khớp khách hàng. Phạm vi của trường này là [0-100]. Giá trị này sẽ rỗng đối với các loại danh sách khác hoặc khi không thể tính tỷ lệ khớp.

Trường này chỉ để đọc.

Trường hợp user_list. Danh sách người dùng.

Bạn phải đặt chính xác một thuộc tính. user_list chỉ có thể là một trong những trạng thái sau:
crmBasedUserList

object (CrmBasedUserListInfo)

Danh sách người dùng gồm những người dùng CRM do nhà quảng cáo cung cấp.
similarUserList

object (SimilarUserListInfo)

Chỉ có đầu ra. Danh sách người dùng tương tự như người dùng trong một Danh sách người dùng khác. Các danh sách này chỉ có thể đọc và do Google tự động tạo.
ruleBasedUserList

object (RuleBasedUserListInfo)

Danh sách người dùng được tạo theo quy tắc.
logicalUserList

object (LogicalUserListInfo)

Danh sách người dùng là danh sách kết hợp tuỳ chỉnh giữa danh sách người dùng và mối quan tâm của người dùng.
basicUserList

object (BasicUserListInfo)

Tiêu chí nhắm mục tiêu theo danh sách người dùng dưới dạng một tập hợp các hành động chuyển đổi hoặc tái tiếp thị.

UserListMembershipStatus

Enum chứa trạng thái thành viên có thể có trong danh sách người dùng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
OPEN Trạng thái mở – Danh sách đang tích luỹ thành viên và có thể được nhắm mục tiêu.
CLOSED Trạng thái đóng cửa – Không có thành viên mới nào được thêm vào. Không thể dùng để nhắm mục tiêu.

UserListSizeRange

Enum chứa các phạm vi kích thước danh sách người dùng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
LESS_THAN_FIVE_HUNDRED Danh sách người dùng có ít hơn 500 người dùng.
LESS_THAN_ONE_THOUSAND Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 500 đến 1000.
ONE_THOUSAND_TO_TEN_THOUSAND Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 1.000 đến 10.000.
TEN_THOUSAND_TO_FIFTY_THOUSAND Danh sách người dùng có số người dùng nằm trong khoảng từ 10.000 đến 50.000.
FIFTY_THOUSAND_TO_ONE_HUNDRED_THOUSAND Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 50.000 đến 100.000.
ONE_HUNDRED_THOUSAND_TO_THREE_HUNDRED_THOUSAND Danh sách người dùng có số người dùng nằm trong khoảng từ 100.000 đến 300.000.
THREE_HUNDRED_THOUSAND_TO_FIVE_HUNDRED_THOUSAND Danh sách người dùng có số người dùng nằm trong khoảng từ 300.000 đến 500.000.
FIVE_HUNDRED_THOUSAND_TO_ONE_MILLION Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 500.000 đến 1 triệu.
ONE_MILLION_TO_TWO_MILLION Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 1 đến 2 triệu.
TWO_MILLION_TO_THREE_MILLION Danh sách người dùng có số lượng người dùng trong khoảng từ 2 đến 3 triệu.
THREE_MILLION_TO_FIVE_MILLION Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 3 đến 5 triệu.
FIVE_MILLION_TO_TEN_MILLION Danh sách người dùng có số lượng người dùng trong khoảng từ 5 đến 10 triệu.
TEN_MILLION_TO_TWENTY_MILLION Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 10 đến 20 triệu.
TWENTY_MILLION_TO_THIRTY_MILLION Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 20 đến 30 triệu.
THIRTY_MILLION_TO_FIFTY_MILLION Danh sách người dùng có số lượng người dùng nằm trong khoảng từ 30 đến 50 triệu.
OVER_FIFTY_MILLION Danh sách người dùng có hơn 50 triệu người dùng.

UserListType

Enum chứa các loại danh sách người dùng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
REMARKETING Danh sách người dùng được biểu thị dưới dạng tập hợp các loại chuyển đổi.
LOGICAL Danh sách người dùng được biểu thị dưới dạng sự kết hợp của các danh sách/mối quan tâm khác của người dùng.
EXTERNAL_REMARKETING Danh sách người dùng được tạo trong nền tảng Google Ad Manager.
RULE_BASED Danh sách người dùng được liên kết với quy tắc.
SIMILAR Danh sách người dùng với những người dùng tương tự như người dùng của một Danh sách người dùng khác.
CRM_BASED Danh sách người dùng chứa dữ liệu CRM của bên thứ nhất do nhà quảng cáo cung cấp dưới dạng email hoặc các định dạng khác.

UserListClosingReason

Enum mô tả lý do đóng danh sách người dùng có thể xảy ra.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
UNUSED Danh sách người dùng này đã bị đóng do không được sử dụng trong hơn một năm.

AccessReason

Enum mô tả các lý do truy cập có thể xảy ra.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
OWNED Tài nguyên thuộc sở hữu của người dùng.
SHARED Tài nguyên được chia sẻ với người dùng.
LICENSED Tài nguyên này được cấp phép cho người dùng.
SUBSCRIBED Người dùng đã đăng ký tài nguyên.
AFFILIATED Người dùng có thể truy cập vào tài nguyên.

UserListAccessStatus

Enum chứa các trạng thái truy cập danh sách người dùng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ENABLED Quyền truy cập đã được bật.
DISABLED Quyền truy cập đã bị vô hiệu hoá.

CrmBasedUserListInfo

Danh sách người dùng gồm những người dùng CRM do nhà quảng cáo cung cấp.

Biểu diễn dưới dạng JSON 
{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}
Trường
uploadKeyType

enum (CustomerMatchUploadKeyType)

Loại khoá trùng khớp của danh sách. Bạn không được phép sử dụng các loại dữ liệu hỗn hợp trên cùng một danh sách. Trường này là bắt buộc cho thao tác THÊM.
dataSourceType

enum (UserListCrmDataSourceType)

Nguồn dữ liệu của danh sách. Giá trị mặc định là first_PARTY. Chỉ những khách hàng trong danh sách cho phép mới có thể tạo danh sách CRM có nguồn của bên thứ ba.
appId

string

Một chuỗi xác định duy nhất ứng dụng di động mà dữ liệu được thu thập từ đó. Đối với iOS, chuỗi mã nhận dạng là chuỗi gồm 9 chữ số xuất hiện ở cuối URL của App Store (ví dụ: "476943146" đối với "Flood-It! 2" có đường liên kết đến App Store là http://itunes.apple.com/us/app/flood-it!-2/id476943146). Đối với Android, chuỗi mã nhận dạng là tên gói của ứng dụng (ví dụ: "com.labpixies.colordrips" cho "Color Drips" theo đường liên kết đến Google Play https://play.google.com/store/apps/details?id=com.labpixies.colordrips). Bắt buộc khi tạo CrmBasedUserList để tải lên mã quảng cáo trên thiết bị di động.

CustomerMatchUploadKeyType

Enum mô tả các loại khoá tải lên có thể có để so khớp khách hàng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
CONTACT_INFO Hệ thống sẽ so khớp các thành viên từ thông tin khách hàng, chẳng hạn như địa chỉ email, số điện thoại hoặc địa chỉ thực tế.
CRM_ID Các thành viên được so khớp từ mã nhận dạng người dùng do nhà quảng cáo tạo và chỉ định.
MOBILE_ADVERTISING_ID Các thành viên được so khớp từ mã quảng cáo trên thiết bị di động.

UserListCrmDataSourceType

Enum mô tả loại nguồn dữ liệu crm của danh sách người dùng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
FIRST_PARTY Dữ liệu được tải lên là dữ liệu của bên thứ nhất.
THIRD_PARTY_CREDIT_BUREAU Dữ liệu được tải lên là do một tổ chức tín dụng bên thứ ba cung cấp.
THIRD_PARTY_VOTER_FILE Dữ liệu được tải lên là từ tệp cử tri của bên thứ ba.

SimilarUserListInfo

SimilarUserList là danh sách người dùng tương tự như người dùng từ một Danh sách người dùng khác. Các danh sách này chỉ có thể đọc và được Google tự động tạo.

Biểu diễn dưới dạng JSON 
{
  "seedUserList": string
}
Trường
seedUserList

string

Danh sách người dùng gốc mà danh sách này bắt nguồn.

RuleBasedUserListInfo

Hình đại diện của một danh sách người dùng được tạo theo quy tắc.

Biểu diễn dưới dạng JSON 
{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}
Trường
prepopulationStatus

enum (UserListPrepopulationStatus)

Trạng thái của quy trình điền sẵn. Trường này được đặt mặc định thành KHÔNG CÓ nếu bạn không đặt, có nghĩa là người dùng trước đó sẽ không được xem xét. Nếu bạn đặt thành REQUESTED, thì khách truy cập trang web hoặc người dùng ứng dụng trong quá khứ phù hợp với định nghĩa danh sách sẽ được đưa vào danh sách (chỉ hoạt động trên Mạng hiển thị). Việc này sẽ chỉ thêm người dùng trong quá khứ trong vòng 30 ngày qua, tuỳ thuộc vào thời hạn thành viên của danh sách và ngày thẻ tiếp thị lại được thêm. Trạng thái sẽ được cập nhật thành HOÀN TẤT khi yêu cầu được xử lý hoặc FAILED nếu yêu cầu không thành công.
flexibleRuleUserList

object (FlexibleRuleUserListInfo)

Thể hiện quy tắc linh hoạt của khách truy cập bằng một hoặc nhiều hành động. Danh sách người dùng linh hoạt được xác định bằng hai danh sách toán hạng – toán hạng bao gồm và toán hạng độc quyền; mỗi toán hạng đại diện cho một tập hợp người dùng dựa trên các hành động mà họ đã thực hiện trong một khung thời gian nhất định. Các danh sách toán hạng này được kết hợp với toán tử AND_NOT, để người dùng được biểu diễn bằng các toán hạng bao gồm sẽ được đưa vào danh sách người dùng, trừ người dùng được biểu diễn bằng các toán hạng độc quyền.

UserListPrepopulationStatus

Enum mô tả trạng thái điền sẵn danh sách người dùng có thể xảy ra.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
REQUESTED Đang yêu cầu điền sẵn.
FINISHED Quá trình điền sẵn đã hoàn tất.
FAILED Không điền trước được.

FlexibleRuleUserListInfo

Thể hiện quy tắc linh hoạt của khách truy cập bằng một hoặc nhiều hành động. Danh sách người dùng linh hoạt được xác định bằng hai danh sách toán hạng – toán hạng bao gồm và toán hạng độc quyền; mỗi toán hạng đại diện cho một tập hợp người dùng dựa trên các hành động mà họ đã thực hiện trong một khung thời gian nhất định. Các danh sách toán hạng này được kết hợp với toán tử AND_NOT, để người dùng được biểu diễn bằng các toán hạng bao gồm sẽ được đưa vào danh sách người dùng, trừ người dùng được biểu diễn bằng các toán hạng độc quyền.

Biểu diễn dưới dạng JSON 
{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}
Trường
inclusiveRuleOperator

enum (UserListFlexibleRuleOperator)

Toán tử xác định cách kết hợp các toán hạng bao gồm.
inclusiveOperands[]

object (FlexibleRuleOperandInfo)

Quy tắc đại diện cho người dùng cần có trong danh sách người dùng. Các toán tử này nằm ở phía bên trái của toán tử AND_NOT, và được kết hợp với nhau bằng AND/OR như được chỉ định bởi includeRuleOperator.
exclusiveOperands[]

object (FlexibleRuleOperandInfo)

Quy tắc đại diện cho những người dùng cần được loại trừ khỏi danh sách người dùng. Các toán tử này nằm ở phía bên phải của toán tử AND_NOT và được kết hợp với nhau bằng OR.

UserListFlexibleRuleOperator

Enum mô tả các toán tử quy tắc kết hợp có thể có cho danh sách người dùng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AND A VÀ B.
OR A HOẶC B.

FlexibleRuleOperandInfo

Quy tắc linh hoạt gói quy tắc chung và giai đoạn xem lại.

Biểu diễn dưới dạng JSON 
{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}
Trường
rule

object (UserListRuleInfo)

Danh sách các nhóm mục quy tắc giúp xác định quy tắc này. Các nhóm mục quy tắc được nhóm lại với nhau.
lookbackWindowDays

string (int64 format)

Giai đoạn xem lại cho quy tắc này tính theo ngày. Từ bây giờ cho đến X ngày trước.

UserListRuleInfo

Quy tắc do khách hàng xác định dựa trên thông số tuỳ chỉnh do các trang web gửi hoặc do nhà quảng cáo tải lên.

Biểu diễn dưới dạng JSON 
{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}
Trường
ruleType

enum (UserListRuleType)

Loại quy tắc được dùng để xác định cách nhóm các mục quy tắc.

Giá trị mặc định là OR của AND (dạng thông thường phân biệt). Tức là các mục quy tắc sẽ được kết hợp với nhau bằng toán tử AND trong các nhóm mục quy tắc và chính các nhóm đó sẽ được OR cùng nhau.

OR của AND là loại duy nhất được hỗ trợ cho linh hoạtRuleUserList.
ruleItemGroups[]

object (UserListRuleItemGroupInfo)

Danh sách các nhóm mục quy tắc giúp xác định quy tắc này. Các nhóm mục quy tắc được nhóm lại với nhau dựa trên RuleType.

UserListRuleType

Enum mô tả các loại quy tắc danh sách người dùng có thể có.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
AND_OF_ORS Dạng thông thường kết hợp.
OR_OF_ANDS Dạng thông thường bất phân.

UserListRuleItemGroupInfo

Một nhóm các mục quy tắc.

Biểu diễn dưới dạng JSON 
{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}
Trường
ruleItems[]

object (UserListRuleItemInfo)

Các mục quy tắc sẽ được nhóm lại với nhau dựa trên RuleType.

UserListRuleItemInfo

Một mục quy tắc phân tử.

Biểu diễn dưới dạng JSON 
{
  "name": string,

  // Union field rule_item can be only one of the following:
  "numberRuleItem": {
    object (UserListNumberRuleItemInfo)
  },
  "stringRuleItem": {
    object (UserListStringRuleItemInfo)
  },
  "dateRuleItem": {
    object (UserListDateRuleItemInfo)
  }
  // End of list of possible types for union field rule_item.
}
Trường
name

string

Tên biến quy tắc. Tên này phải khớp với tên khoá tương ứng do pixel kích hoạt. Tên phải bắt đầu bằng các chữ cái ASCII của Hoa Kỳ hoặc dấu gạch dưới hoặc mã UTF8 lớn hơn 127 và bao gồm các chữ cái hoặc chữ số của US-Ascii, hoặc dấu gạch dưới hoặc mã UTF8 lớn hơn 127. Đối với các trang web, có hai URL biến được tích hợp sẵn (name = 'url__') và URL liên kết giới thiệu (name = 'ref_url__'). Bạn phải điền sẵn trường này khi tạo một mục quy tắc mới.
Trường hợp rule_item. Một mục quy tắc phân tử. rule_item chỉ có thể là một trong những trạng thái sau:
numberRuleItem

object (UserListNumberRuleItemInfo)

Một mục quy tắc nguyên tử bao gồm một phép toán số.
stringRuleItem

object (UserListStringRuleItemInfo)

Một mục quy tắc nguyên tử bao gồm một toán tử chuỗi.
dateRuleItem

object (UserListDateRuleItemInfo)

Một mục quy tắc nguyên tử bao gồm toán tử ngày.

UserListNumberRuleItemInfo

Một mục quy tắc bao gồm một toán tử số.

Biểu diễn dưới dạng JSON 
{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}
Trường
operator

enum (UserListNumberRuleItemOperator)

Toán tử so sánh số. Trường này là bắt buộc và phải được điền khi tạo mục quy tắc số mới.
value

number

Giá trị số cần so sánh với biến. Trường này là bắt buộc và phải được điền khi tạo mục quy tắc số mới.

UserListNumberRuleItemOperator

Enum mô tả các toán tử có thể có của mục quy tắc số cho danh sách người dùng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
GREATER_THAN Lớn hơn.
GREATER_THAN_OR_EQUAL Lớn hơn hoặc bằng.
EQUALS Bằng.
NOT_EQUALS Không bằng.
LESS_THAN Nhỏ hơn.
LESS_THAN_OR_EQUAL Nhỏ hơn hoặc bằng.

UserListStringRuleItemInfo

Một mục quy tắc bao gồm một toán tử chuỗi.

Biểu diễn dưới dạng JSON 
{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}
Trường
operator

enum (UserListStringRuleItemOperator)

Toán tử so sánh chuỗi. Trường này là bắt buộc và phải được điền khi tạo một mục quy tắc chuỗi mới.
value

string

Phía bên phải của mục quy tắc chuỗi. Đối với URL hoặc URL liên kết giới thiệu, giá trị này không được chứa ký tự URL không hợp lệ như dòng mới, dấu ngoặc kép, thẻ hoặc dấu ngoặc đơn. Trường này là bắt buộc và phải được điền khi tạo một mục quy tắc chuỗi mới.

UserListStringRuleItemOperator

Enum mô tả các toán tử có thể có cho mục của quy tắc chuỗi trong danh sách người dùng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
CONTAINS Chứa.
EQUALS Bằng.
STARTS_WITH Bắt đầu bằng.
ENDS_WITH Kết thúc bằng.
NOT_EQUALS Không bằng.
NOT_CONTAINS Không chứa.
NOT_STARTS_WITH Không bắt đầu bằng.
NOT_ENDS_WITH Không kết thúc bằng.

UserListDateRuleItemInfo

Một mục quy tắc bao gồm toán tử ngày.

Biểu diễn dưới dạng JSON 
{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}
Trường
operator

enum (UserListDateRuleItemOperator)

Toán tử so sánh ngày. Đây là trường bắt buộc và phải được điền khi tạo mục quy tắc ngày mới.
value

string

Chuỗi biểu thị giá trị ngày sẽ được so sánh với biến quy tắc. Định dạng ngày được hỗ trợ là YYYY-MM-DD. Thời gian được báo cáo theo múi giờ của khách hàng.
offsetInDays

string (int64 format)

Giá trị ngày tương đối của phía bên phải được biểu thị bằng số ngày bù trừ kể từ bây giờ. Trường giá trị sẽ ghi đè trường này khi có cả hai trường.

UserListDateRuleItemOperator

Enum mô tả các toán tử có thể có của mục quy tắc ngày trong danh sách người dùng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
EQUALS Bằng.
NOT_EQUALS Không bằng.
BEFORE Trước đây.
AFTER Sau.

LogicalUserListInfo

Đại diện cho một danh sách người dùng là một tổ hợp danh sách người dùng tuỳ chỉnh.

Biểu diễn dưới dạng JSON 
{
  "rules": [
    {
      object (UserListLogicalRuleInfo)
    }
  ]
}
Trường
rules[]

object (UserListLogicalRuleInfo)

Quy tắc danh sách logic xác định danh sách người dùng này. Các quy tắc được xác định dưới dạng toán tử logic (TẤT CẢ/BẤT KỲ/NONE) và danh sách danh sách người dùng. Tất cả các quy tắc đều được thêm vào AND khi chúng được đánh giá.

Bắt buộc để tạo danh sách người dùng hợp lý.

UserListLogicalRuleInfo

Quy tắc logic cho danh sách người dùng. Quy tắc có toán tử logic (và/hoặc/không) và danh sách người dùng dưới dạng toán hạng.

Biểu diễn dưới dạng JSON 
{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}
Trường
operator

enum (UserListLogicalRuleOperator)

Toán tử logic của quy tắc.
ruleOperands[]

object (LogicalUserListOperandInfo)

Danh sách các toán hạng của quy tắc.

UserListLogicalRuleOperator

Enum mô tả các toán tử có thể có cho quy tắc logic cho danh sách người dùng.

Enum
UNSPECIFIED Chưa chỉ định.
UNKNOWN Chỉ dùng cho giá trị trả về. Đại diện cho giá trị không xác định trong phiên bản này.
ALL Và - tất cả các toán hạng.
ANY Hoặc - ít nhất một trong các toán hạng.
NONE Không – không có toán hạng nào.

LogicalUserListOperandInfo

Toán hạng của danh sách người dùng được xác định theo logic bao gồm một danh sách người dùng.

Biểu diễn dưới dạng JSON 
{
  "userList": string
}
Trường
userList

string

Tên tài nguyên của danh sách người dùng dưới dạng toán hạng.

BasicUserListInfo

Tiêu chí nhắm mục tiêu theo danh sách người dùng dưới dạng một tập hợp các lượt chuyển đổi hoặc hành động tái tiếp thị.

Biểu diễn dưới dạng JSON 
{
  "actions": [
    {
      object (UserListActionInfo)
    }
  ]
}
Trường
actions[]

object (UserListActionInfo)

Các hành động được liên kết với danh sách người dùng này.

UserListActionInfo

Đại diện cho loại hành động được dùng để tạo danh sách người dùng tái tiếp thị.

Biểu diễn dưới dạng JSON 
{

  // Union field user_list_action can be only one of the following:
  "conversionAction": string,
  "remarketingAction": string
  // End of list of possible types for union field user_list_action.
}
Trường
Trường hợp user_list_action. Loại phụ của thao tác đối với danh sách người dùng. user_list_action chỉ có thể là một trong những trạng thái sau:
conversionAction

string

Hành động chuyển đổi không được tạo từ hoạt động tái tiếp thị.
remarketingAction

string

Hành động tái tiếp thị.