targetingBehavior

Таргетировать размещение кампании на площадке по поведению. Только для продукта ADFOX.Nets.

  1. Формат запроса
  2. Формат ответа
  3. Параметры ответа
  4. Другие действия с объектом

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

https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=campaign
 & action=targetPlace
 & actionObject=targetingBehavior
 & objectID=<integer>
 & placeID=<integer>
 & isRedefined=<integer>
 & behaviorMode=<integer>
 & [UTLogic=<integer>]
 & [UTNotN=<integer>]
 & [categoryIDN=<integer>]
 & [visitsN=<integer>]
 & [timeoutN=<integer>]
 & [UTSVisitsN=<integer>]
 & [UTSTimeoutN=<integer>]
Query-параметры
objectID *ID объекта, над которым производится действие.
placeID *

ID площадки.

isRedefined *

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

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

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

Использовать таргетирование по поведению для пользователей, размеченных с помощью:

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

В таргетировании по поведению рекламодатель сам регулирует условия, при соблюдении которых разрешен показ рекламного объявления.

Есть два режима соблюдения условий: «верно любое из заданных условий» и «верны все условия». Можно задать до 9 условий, каждое условие состоит из 4-х параметров, где N в названии параметра — номер условия от 1 до 9:

  • размеченные/не размеченные пользователи (UTNotN);
  • если пользователь размечен, то с какой категорией (categoryIDN);
  • сколько раз пользователь был размечен (visitsN);
  • когда пользователь был размечен последний раз (timeoutN).

Укажите логику соблюдения условий для показа баннеров рекламной кампании пользователям.

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

  • 0 — верно любое из заданных условий;
  • 1 — верны все заданные условия.
UTNotN

Выбрать целевую аудиторию: размеченные или не размеченные пользователи, где N в названии параметра — номер условия от 1 до 9.

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

  • 0 — условие не задано;
  • 1 — размеченные пользователи;
  • 2 — не размеченные пользователи.

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

categoryIDN

Укажите, с какой категорией должен быть размечен пользователь, где N в названии параметра — номер условия от 1 до 9.

Допустимые значения: идентификатор категории.

Значение по умолчанию: 0 — не задано, если таргетирование проводится на неразмеченных пользователей.

См. также:

visitsN

Укажите, сколько раз пользователь должен быть размечен, где N в названии параметра — номер условия от 1 до 9.

Допустимые значения: целое число от 1 до 2147483647.

timeoutN

Укажите, сколько дней назад пользователь должен быть размечен в последний раз, где N в названии параметра — номер условия от 1 до 9.

Допустимые значения: целое число от 1 до 2147483647.

UTSVisitsN

Посещений не менее заданного числа раз, где N — номер условия.

Допустимые значения: целое число от 1 до 2147483647.

UTSTimeoutN

Последнее посещение было не позднее чем заданное число дней назад, где N — номер условия.

Допустимые значения: целое число от 1 до 2147483647.

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

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

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

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

code

Статус обработки запроса. Расшифровку смотрите в разделе Обработка ошибок.

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

Запрос:

https://api.adfox.ru/v1/API.php?loginAccount={your_login}&loginPassword={sha256_your_password}&object=campaign&action=targetPlace&actionObject=targetingBehavior&objectID=474205&behaviorMode=1&placeID=321&isRedefined=1

Ответ:

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

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

См. также другие действия с объектом campaign: