UserList

{
  "uploadKeyType": enum (CustomerMatchUploadKeyType),
  "dataSourceType": enum (UserListCrmDataSourceType),
  "appId": string
}

enum (CustomerMatchUploadKeyType)

列表的匹配键类型。同一列表中不允许混合的数据类型。对 ADD 操作而言，此字段是必填字段。

enum (UserListCrmDataSourceType)

列表的数据源。默认值为 FIRST_PARTY。只有许可名单中的客户才能创建第三方来源的 CRM 名单。

string

一个字符串，用于唯一标识从中收集数据的移动应用。对于 iOS，ID 字符串是显示在 App Store 网址末尾的 9 位数字符串（例如，“476943146”表示“Flood-It!”2"，其 App Store 链接为 http://itunes.apple.com/us/app/flood-it!-2/id476943146)。对于 Android，ID 字符串是应用的软件包名称（例如，如果 Google Play 链接为 https://play.google.com/store/apps/details?id=com.labpixies.colordrips)，则 ID 字符串是应用的软件包名称，例如“com.labpixies.colordrips”对应“Color Drips”）。创建用于上传移动广告 ID 的 CrmBasedUserList 时是必需的。

{
  "seedUserList": string
}

string

派生此列表的 Seed UserList。

{
  "prepopulationStatus": enum (UserListPrepopulationStatus),
  "flexibleRuleUserList": {
    object (FlexibleRuleUserListInfo)
  }
}

enum (UserListPrepopulationStatus)

预填充的状态。如果未设置此字段，则默认为“NONE”，这意味着之前的用户不予考虑。如果设为 REQUESTED，则符合列表定义的过往网站访问者或应用用户将会包含在该列表中（仅适用于展示广告网络）。此操作仅会添加过去 30 天内的过往用户，具体取决于名单的成员资格有效期和添加再营销代码的日期。请求处理完毕后，状态将更新为 FINISHED，如果请求失败，状态将更新为 FAILED。

object (FlexibleRuleUserListInfo)

可以灵活设置访问者执行一项或多项操作的规则。灵活用户名单由两个操作数列表定义，即 PSYA 项和 修饰运算数；每个操作数代表一组用户，基于用户在给定时间范围内执行的操作。这些操作数列表使用 AND_NOT 运算符合并，这样，由包含的操作数表示的用户就会被包含在用户列表中，减去用排除操作数表示的用户的数量。

{
  "inclusiveRuleOperator": enum (UserListFlexibleRuleOperator),
  "inclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ],
  "exclusiveOperands": [
    {
      object (FlexibleRuleOperandInfo)
    }
  ]
}

enum (UserListFlexibleRuleOperator)

用于定义如何组合包含运算数的运算符。

object (FlexibleRuleOperandInfo)

代表应包含在用户列表中的用户的规则。这些运算符位于 AND_NOT 运算符的左侧，并且按照 inclusiveRuleOperator 的指定通过 AND/OR 连接在一起。

object (FlexibleRuleOperandInfo)

代表应从用户列表中排除的用户的规则。这些位于 AND_NOT 运算符的右侧，并通过 OR 连接在一起。

{
  "rule": {
    object (UserListRuleInfo)
  },
  "lookbackWindowDays": string
}

object (UserListRuleInfo)

用于定义此规则的规则项组列表。规则项目组会归为一组。

string (int64 format)

此规则的回溯期（以天为单位）。从现在到 X 天前。

{
  "ruleType": enum (UserListRuleType),
  "ruleItemGroups": [
    {
      object (UserListRuleItemGroupInfo)
    }
  ]
}

enum (UserListRuleType)

规则类型用于确定如何对规则项进行分组。

默认值为 AND（析取范式）的 OR（或运算）。也就是说，各规则项目组内的各规则项目之间以 AND 关系串联，且各组规则项目之间以 OR 关系结合在一起。

“AND”的 OR 是 FlexibleRuleUserList 唯一支持的类型。

object (UserListRuleItemGroupInfo)

用于定义此规则的规则项组列表。规则项目组根据规则类型进行分组。

{
  "ruleItems": [
    {
      object (UserListRuleItemInfo)
    }
  ]
}

object (UserListRuleItemInfo)

根据规则类型归为一组的规则项。

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

string

规则变量名称。它应与像素触发的相应键名保持一致。名称必须以 US-ASCII 字母或下划线或大于 127 的 UTF8 代码开头，并且由 US-ASCII 字母或数字、下划线或大于 127 的 UTF8 代码组成。对于网站，有两个内置变量网址（名称 = 'url__'）和引荐来源网址（名称 = 'ref_url__'）。创建新的规则项时，必须填充此字段。

object (UserListNumberRuleItemInfo)

由数字运算组成的原子规则项。

object (UserListStringRuleItemInfo)

由字符串操作组成的原子规则项。

object (UserListDateRuleItemInfo)

由日期操作组成的原子规则项。

{
  "operator": enum (UserListNumberRuleItemOperator),
  "value": number
}

enum (UserListNumberRuleItemOperator)

数字比较运算符。此字段是必填字段，在创建新的数字规则项时必须填写。

number

要与变量进行比较的数值。此字段是必填字段，在创建新的数字规则项时必须填写。

{
  "operator": enum (UserListStringRuleItemOperator),
  "value": string
}

enum (UserListStringRuleItemOperator)

字符串比较运算符。此字段是必填字段，在创建新字符串规则项时必须填写。

string

字符串规则项的右侧。对于网址或引荐来源网址，此值不得包含非法网址字符，例如换行符、引号、制表符或括号。此字段是必填字段，在创建新字符串规则项时必须填写。

{
  "operator": enum (UserListDateRuleItemOperator),
  "value": string,
  "offsetInDays": string
}

enum (UserListDateRuleItemOperator)

日期比较运算符。此字段是必填字段，在创建新日期规则项时必须填写。

string

一个字符串，表示要与规则变量进行比较的日期值。支持的日期格式为 YYYY-MM-DD。系统会按照客户所在的时区报告时间。

string (int64 format)

右侧的相对日期值，以距现在的天数表示。如果两个字段都存在，则 value 字段会覆盖此字段。

{
  "rules": [
    {
      object (UserListLogicalRuleInfo)
    }
  ]
}

object (UserListLogicalRuleInfo)

用于定义此用户列表的逻辑列表规则。这些规则以逻辑运算符（ALL/ANY/NONE）和用户列表的形式定义。所有规则在求值时均以 AND 关系计算。

创建逻辑用户列表时必填。

{
  "operator": enum (UserListLogicalRuleOperator),
  "ruleOperands": [
    {
      object (LogicalUserListOperandInfo)
    }
  ]
}

enum (UserListLogicalRuleOperator)

规则的逻辑运算符。

object (LogicalUserListOperandInfo)

规则的操作数列表。

{
  "userList": string
}

string

作为操作数的用户名单的资源名称。

{
  "actions": [
    {
      object (UserListActionInfo)
    }
  ]
}

object (UserListActionInfo)

与此用户名单关联的操作。

{

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

string

并非通过再营销生成的转化操作。

string

再营销操作。

{
  "seedUserListIds": [
    string
  ],
  "expansionLevel": enum (LookalikeExpansionLevel),
  "countryCodes": [
    string
  ]
}

string (int64 format)

从中派生此列表的种子用户列表 ID，由用户提供。

enum (LookalikeExpansionLevel)

扩展级别，反映相似受众群体的规模

string

相似细分受众群定位到的国家/地区。由 ISO-3166 定义的双字母国家/地区代码