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

自定义受众群体的名称。对于客户创建的所有自定义受众群体，该 ID 应该是唯一的。必须填写此字段才能创建操作。
type

enum (CustomAudienceType)

自定义受众群体的类型。（“INTEREST”OR“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 安装了移动应用的用户。