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

自定义受众群体的成员。成员可以是 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 已安装移动应用的用户。