CustomInterest

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

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

string

不可变。自定义兴趣的资源名称。自定义兴趣资源名称的格式为:

customers/{customerId}/customInterests/{custom_interest_id}

status

enum (CustomInterestStatus)

此自定义兴趣的状态。指示自定义兴趣是启用还是已移除。

type

enum (CustomInterestType)

自定义兴趣的类型,即 CUSTOM_AFFINITY 或 CUSTOM_INTENT。默认情况下,该类型设置为 CUSTOM_AFFINITY。

members[]

object (CustomInterestMember)

此自定义兴趣所包含的自定义兴趣成员的列表。您可以在创建自定义兴趣时添加成员。如果 UPDATE 操作中出现成员,则现有成员将被覆盖。

id

string (int64 format)

仅限输出。自定义兴趣的 ID。

name

string

自定义兴趣的名称。在同一自定义兴趣相似受众群体中,此维度值应是唯一的。此字段对创建操作是必需的。

description

string

此自定义兴趣受众群体的说明。

CustomInterestStatus

包含可能的自定义兴趣类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
ENABLED 已启用状态 - 自定义兴趣已启用,可用于定位。
REMOVED 已移除状态 - 自定义兴趣已移除,无法用于定位。

CustomInterestType

包含可能的自定义兴趣类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
CUSTOM_AFFINITY 允许品牌广告客户定义自定义的兴趣相似受众群体名单。
CUSTOM_INTENT 允许广告客户定义自定义的意向受众群体名单。

CustomInterestMember

自定义兴趣受众群体的成员。成员可以是关键字或网址。它不可变,也就是说,只能创建或移除,而无法更改。

JSON 表示法
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
字段
memberType

enum (CustomInterestMemberType)

自定义兴趣成员的类型,即“关键字”或“网址”。

parameter

string

如果 memberType 为 KEYWORD,则为关键字文字;如果 memberType 为 URL,则为网址字符串。

CustomInterestMemberType

包含可能的自定义兴趣成员类型的枚举。

枚举
UNSPECIFIED 未指定。
UNKNOWN 仅用于返回值。表示此版本中未知的值。
KEYWORD 自定义兴趣成员类型为“关键字”。
URL 自定义兴趣会员类型网址。