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”OR“PURCHASE_INTENT”；但对于现有受众群体，则保留“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

自定义受众群体的成员。成员可以是 KEYWORD、网址、PLACE_CATEGORY 或 APP。成员只能创建或移除，但不能更改。

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 已安装移动应用的用户。