CustomAudience

自定义受众群体。这是按兴趣划分的用户列表。

JSON 表示法 
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
字段
resourceName

string

不可变。自定义受众群体的资源名称。自定义受众群体资源名称的格式为：

customers/{customerId}/customAudiences/{custom_audience_id}
id

string (int64 format)

仅限输出。自定义受众群体的 ID。
status

enum (CustomAudienceStatus)

仅限输出。此自定义受众群体的状态。指示自定义受众群体是处于启用还是移除状态。
name

string

自定义受众群体的名称。它应与客户创建的所有自定义受众群体不同。创建操作时，此字段是必填字段。
type

enum (CustomAudienceType)

自定义受众群体的类型。（不允许为新创建的自定义受众群体使用“INTEREST”或“PURCHASE_INTENT”，但现有受众群体可以保留这两个维度）
description

string

此自定义受众群体的说明。
members[]

object (CustomAudienceMember)

此自定义受众群体所包含的自定义受众群体成员的列表。您可以在创建 CustomAudience 时添加成员。如果成员在 UPDATE 操作中显示，则现有成员将被覆盖。

CustomAudienceStatus

包含可能的自定义受众群体状态的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 已启用状态 - 自定义受众群体已启用，可以定位到。
REMOVED 已移除状态 - 自定义受众群体已移除，无法用于定位。

CustomAudienceType

包含可能的自定义受众群体类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
AUTO Google Ads 会在投放时自动选择最佳解释。
INTEREST 根据用户的兴趣进行匹配。
PURCHASE_INTENT 根据用户正在研究的主题或考虑购买的产品来匹配用户。
SEARCH 根据用户在 Google 搜索上搜索的内容来匹配用户。

CustomAudienceMember

自定义受众群体的成员。成员可以是关键字、网址、地点类别或应用。只能创建或移除，而无法更改。

JSON 表示法 
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
字段
memberType

enum (CustomAudienceMemberType)

自定义受众群体成员的类型，包括 KEYWORD、网址、PLACE_CATEGORY 或 APP。
联合字段 value。CustomAudienceMember 值。系统会根据成员类型填充一个字段。value 只能是下列其中一项：
keyword

string

关键字或关键字词组 - 最多 10 个字词和 80 个字符。对于中文、日语或韩语等全角字符语言，此字段的字符数限制为 40 个，用于描述用户的兴趣或操作。
url

string

包含协议的 HTTP 网址（最多 2048 个字符），其中包含用户感兴趣的内容。
placeCategory

string (int64 format)

由用户光顾的地点类别描述的地点类型。
app

string

用户安装的 Android 应用的软件包名称，例如 com.google.example。

CustomAudienceMemberType

包含可能的自定义受众群体成员类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
KEYWORD 兴趣或操作可用关键字描述的用户。
URL 兴趣与网站内容相关的用户。
PLACE_CATEGORY 访问某个地点类别描述的地点类型的用户。
APP 已安装移动应用的用户。