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

当成员类型为 KEYWORD 时,返回关键字文字;或者当成员类型为网址时,返回网址字符串。

CustomInterestMemberType

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

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