CustomAudience

Индивидуальная аудитория. Это список пользователей по интересам.

JSON-представление
{
  "resourceName": string,
  "id": string,
  "status": enum (CustomAudienceStatus),
  "name": string,
  "type": enum (CustomAudienceType),
  "description": string,
  "members": [
    {
      object (CustomAudienceMember)
    }
  ]
}
Поля
resourceName

string

Неизменный. Имя ресурса пользовательской аудитории. Имена ресурсов пользовательской аудитории имеют вид:

customers/{customerId}/customAudiences/{custom_audience_id}

id

string ( int64 format)

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

status

enum ( CustomAudienceStatus )

Только вывод. Статус этой индивидуальной аудитории. Указывает, включена или удалена пользовательская аудитория.

name

string

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

type

enum ( CustomAudienceType )

Тип пользовательской аудитории. («ИНТЕРЕСТ» ИЛИ «PURCHASE_INTENT» не разрешен для вновь созданной индивидуальной аудитории, но сохраняется для существующих аудиторий)

description

string

Описание этой индивидуальной аудитории.

members[]

object ( CustomAudienceMember )

Список участников индивидуальной аудитории, из которых состоит эта пользовательская аудитория. Участников можно добавлять во время создания CustomAudience. Если члены представлены в операции UPDATE, существующие члены будут переопределены.

CustomAudienceStatus

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

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

CustomAudienceType

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
AUTO Google Реклама автоматически выберет лучшую интерпретацию во время показа.
INTEREST Сопоставляет пользователей по их интересам.
PURCHASE_INTENT Сопоставляет пользователей по темам, которые они исследуют, или по продуктам, которые они рассматривают для покупки.
SEARCH Сопоставляет пользователей по тому, что они искали в Google Поиске.

CustomAudienceMember

Член пользовательской аудитории. Участником может быть КЛЮЧЕВОЕ СЛОВО, URL, PLACE_CATEGORY или ПРИЛОЖЕНИЕ. Его можно только создать или удалить, но нельзя изменить.

JSON-представление
{
  "memberType": enum (CustomAudienceMemberType),

  // Union field value can be only one of the following:
  "keyword": string,
  "url": string,
  "placeCategory": string,
  "app": string
  // End of list of possible types for union field value.
}
Поля
memberType

enum ( CustomAudienceMemberType )

Тип специального участника аудитории: KEYWORD, URL, PLACE_CATEGORY или APP.

value поля объединения. Значение CustomAudienceMember. Одно поле заполняется в зависимости от типа элемента. value может быть только одним из следующих:
keyword

string

Ключевое слово или ключевая фраза — максимум 10 слов и 80 символов. В языках с символами двойной ширины, таких как китайский, японский или корейский, допускается использование 40 символов, описывающих интересы или действия пользователя.

url

string

URL-адрес HTTP, включая протокол — не более 2048 символов, включая контент, который интересует пользователей.

placeCategory

string ( int64 format)

Тип места, описываемый категорией мест, которую посещают пользователи.

app

string

Имя пакета приложений Android, установленных пользователями, например com.google.example.

CustomAudienceMemberType

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

Перечисления
UNSPECIFIED Не указан.
UNKNOWN Используется только для возвращаемого значения. Представляет значение, неизвестное в этой версии.
KEYWORD Пользователи, чьи интересы или действия описаны ключевым словом.
URL Пользователи, интересы которых связаны с содержанием сайта.
PLACE_CATEGORY Пользователи, посещающие типы мест, описанные категорией мест.
APP Пользователи, установившие мобильное приложение.