自定义受众群体。这是按兴趣细分的用户列表。
JSON 表示法 |
---|
{ "resourceName": string, "id": string, "status": enum ( |
字段 | |
---|---|
resourceName |
不可变。自定义受众群体的资源名称。自定义受众群体资源名称采用以下格式:
|
id |
仅供输出。自定义受众群体的 ID。 |
status |
仅供输出。此自定义受众群体的状态。指明自定义受众群体是已启用还是已移除。 |
name |
自定义受众群体的名称。它对于客户创建的所有自定义受众群体而言应该是唯一的。必须填写此字段才能创建操作。 |
type |
自定义受众群体的类型。(对于新创建的自定义受众群体,不允许使用“INTEREST”或“PURCHASE_INTENT”,但对于现有受众群体,不允许将其保留) |
description |
此自定义受众群体的说明。 |
members[] |
此自定义受众群体所含的自定义受众群体成员的列表。可在创建 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 ( |
字段 | |
---|---|
memberType |
自定义受众群体成员的类型,KEYWORD、网址、PLACE_CATEGORY 或 APP。 |
联合字段 value 。CustomAudienceMember 值。系统会根据成员类型填充一个字段。value 只能是下列其中一项: |
|
keyword |
关键字或关键字词组 — 最多 10 个字词和 80 个字符。中文、日语或韩语等全角字符语言可以包含 40 个字符,用于描述用户的兴趣或操作。 |
url |
包含协议的 HTTP 网址,最多 2048 个字符,包含用户感兴趣的内容。 |
placeCategory |
由用户访问的地点类别描述的地点类型。 |
app |
用户已安装的 Android 应用的软件包名称,例如 com.google.example. |
CustomAudienceMemberType
包含可能的自定义受众群体成员类型的枚举。
枚举 | |
---|---|
UNSPECIFIED |
未指定。 |
UNKNOWN |
仅用于返回值。表示此版本中的未知值。 |
KEYWORD |
兴趣或操作由关键字描述的用户。 |
URL |
对网站内容感兴趣的用户。 |
PLACE_CATEGORY |
访问地点类别所描述地点类型的用户。 |
APP |
已安装移动应用的用户。 |