category

Добавить категорию. Категория — это механизм, позволяющий произвести разметку сайта (например, по тематическим зонам) для получения статистики о показах и переходах внутри категории, а также сгруппировать сайты по категориям в рекламных сетях. Дополнительно категории используются для разметки аудитории и настройки поведенческого таргетирования.

Формат запроса

https://adfox.yandex.ru/api/v1
  ? object=account
  & action=add
  & actionObject=category
  & name=<string>
  & [type=<integer>]
  & [timeout=<integer>]

name*

Название объекта. Может содержать русские и латинские буквы, цифры и любые символы.

type

Тип категории.

Допустимые значения:

  • 0 — постоянная категория. Используется для разметки сайтов, разделов и площадок.
  • 1 — временная категория. Используется для настройки поведенческого таргетирования.

Значение по умолчанию: 0.

timeout

Активность (дней).

Значение по умолчанию: не задано.

* Обязательный параметр

Формат ответа

<response>
<status>
  <code>{integer}</code>
  <ID>{integer}</ID>
</status>
</response>

Параметры ответа

code

Статус обработки запроса. Значение 0 — запрос выполнен успешно. Расшифровку смотрите в разделе Обработка ошибок.

ID

Идентификатор созданного объекта.

Пример запроса и ответа

Запрос:

https://adfox.yandex.ru/api/v1?object=account&action=add&actionObject=category&name=avto&type=1

Ответ:

<response>
<status>
  <code>0</code>
  <ID>4</ID>
</status>
</response>

Другие действия с объектом

Читайте также о других действиях с объектом category:

Предыдущая
campaign
Следующая
contract
В этой статье: