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)

包含此自定义兴趣的自定义兴趣成员列表。成员可以在创建 CustomInterest 时添加。如果 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)

自定义兴趣成员的类型、KEYWORD 或网址。

parameter

string

当 memberType 为“KEYWORD”时的关键字文字或“memberType”为“网址”时的网址字符串。

CustomInterestMemberType

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

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