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)

Только вывод. Идентификатор пользовательского интереса.

name

string

Имя пользовательского интереса. Он должен быть уникальным для одной и той же аудитории по интересам. Это поле является обязательным для операций создания.

description

string

Описание этой аудитории по особым интересам.

CustomInterestStatus

Перечисление, содержащее возможные пользовательские типы интересов.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
ENABLED Статус «Включено» — индивидуальный интерес включен и на него можно ориентироваться.
REMOVED Статус «Удален» — специальный интерес удален и не может использоваться для таргетинга.

ПользовательскийИнтерестТип

Перечисление, содержащее возможные пользовательские типы интересов.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
CUSTOM_AFFINITY Позволяет рекламодателям брендов определять собственные списки аудиторий по интересам.
CUSTOM_INTENT Позволяет рекламодателям определять собственные списки аудитории по намерениям.

ПользовательскийИнтерестМембер

Член аудитории по особым интересам. Участником может быть ключевое слово или URL-адрес. Он неизменяем, то есть его можно только создать или удалить, но нельзя изменить.

JSON-представление
{
  "memberType": enum (CustomInterestMemberType),
  "parameter": string
}
Поля
memberType

enum ( CustomInterestMemberType )

Тип пользовательского элемента интересов: KEYWORD или URL.

parameter

string

Текст ключевого слова, еслиmemberType — это KEYWORD, или строка URL, еслиmemberType — это URL.

CustomInterestMemberType

Перечисление, содержащее возможные типы пользовательских интересов.

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
KEYWORD Пользовательский тип элемента интересов KEYWORD.
URL URL-адрес пользовательского типа участника интересов.