targetingUser

Таргетировать баннер по пользовательским характеристикам.

Таргетирование по пользовательским характеристикам — это вид таргетирования, где клиент Adfox самостоятельно определяет характеристики для выбора целевой аудитории. Каждая характеристика содержит набор значений, которые известны сайту о посетителе, либо о странице сайта. Передача значений для таргетирования осуществляется со стороны сайта через код вставки.

Для настройки таргетирования включите характеристику и добавьте список значений.

В код вставки добавьте к параметру puidN, где N — номер характеристики от 1 до 63, значение или список значений через разделитель (двоеточие), для выбора рекламных кампаний, таргетированных на эти значения.

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

https://adfox.yandex.ru/api/v1
  ? object=banner
  & action=target
  & actionObject=targetingUser
  & objectID=<integer>
  & isRedefined=<integer>
  & criteriaID=<integer>
  & vN=<integer>

objectID*

ID объекта, над которым производится действие.

isRedefined*

Переопределить таргетирование.

Возможные значения:

  • 0 — наследовать настройки таргетирования, установленные на уровне выше. Иерархия уровней от верхнего к нижнему:

    • кампания;
    • размещение кампании на сайте;
    • размещение кампании на разделе сайта;
    • размещение кампании на площадке;
    • баннер.
  • 1 — отменить настройки таргетирования на более высоких уровнях и использовать настройки, установленные на текущем уровне.

criteriaID*

ID характеристики.

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

  • 1≤N≤63, где N — порядковый номер характеристики от 1 до 63 включительно.

vN*

Где N в названии параметра — ID значения характеристики.

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

  • 0 — выключить;
  • 1 — включить.

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

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

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

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

code

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

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

Запрос:

https://adfox.yandex.ru/api/v1?object=banner&action=target&actionObject=targetingUser&objectID=474205&criteriaId=1&v5345=1&isRedefined=1

Ответ:

<response>
<status>
  <code>0</code>
</status>
</response>

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

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

Предыдущая
Следующая