targetingBehavior
Таргетировать размещение кампании на сайте по поведению.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=campaign
& action=targetWebsite
& actionObject=targetingBehavior
& objectID=<integer>
& siteID=<integer>
& isRedefined=<integer>
& behaviorMode=<integer>
& [UTLogic=<integer>]
& [UTNotN=<integer>]
& [categoryIDN=<integer>]
& [visitsN=<integer>]
& [timeoutN=<integer>]
& [UTSVisitsN=<integer>]
& [UTSTimeoutN=<integer>]
|
ID объекта, над которым производится действие. |
|
ID сайта. |
|
Переопределить таргетирование. Возможные значения:
|
|
Использовать таргетирование по поведению для пользователей, размеченных с помощью:
|
|
В таргетировании по поведению рекламодатель сам регулирует условия, при соблюдении которых разрешен показ рекламного объявления. Есть два режима соблюдения условий: «верно любое из заданных условий» и «верны все условия». Можно задать до 9 условий, каждое условие состоит из 4-х параметров, где N в названии параметра — номер условия от 1 до 9:
Укажите логику соблюдения условий для показа баннеров рекламной кампании пользователям. Допустимые значения:
|
|
Выбрать целевую аудиторию: размеченные или не размеченные пользователи, где N в названии параметра — номер условия от 1 до 9. Допустимые значения:
Значение по умолчанию: |
|
Укажите, с какой категорией должен быть размечен пользователь, где N в названии параметра — номер условия от 1 до 9. Допустимые значения: идентификатор категории. Значение по умолчанию: Читайте также: |
|
Укажите, сколько раз пользователь должен быть размечен, где N в названии параметра — номер условия от 1 до 9. Допустимые значения: целое число от 1 до 2147483647. |
|
Укажите, сколько дней назад пользователь должен быть размечен в последний раз, где N в названии параметра — номер условия от 1 до 9. Допустимые значения: целое число от 1 до 2147483647. |
|
Посещений не менее заданного числа раз, где N — номер условия. Допустимые значения: целое число от 1 до 2147483647. |
|
Последнее посещение было не позднее чем заданное число дней назад, где N — номер условия. Допустимые значения: целое число от 1 до 2147483647. |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=campaign&action=targetWebsite&actionObject=targetingBehavior&objectID=474205&behaviorMode=1&siteID=321&isRedefined=1
Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом campaign
:
- добавить кампанию
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- получить список баннеров рекламной кампании;
- разместить кампанию на сайте, разделе, площадке;
ID объекта, над которым производится действие.
ID сайта.
Переопределить таргетирование.
Возможные значения:
-
0
— наследовать настройки таргетирования, установленные на уровне выше. Иерархия уровней от верхнего к нижнему:-
кампания;
-
размещение кампании на сайте;
-
размещение кампании на разделе сайта;
-
размещение кампании на площадке;
-
баннер.
-
-
1
— отменить настройки таргетирования на более высоких уровнях и использовать настройки, установленные на текущем уровне.
Использовать таргетирование по поведению для пользователей, размеченных с помощью:
-
0
— постоянной категории, если разметка аудитории производится с помощью указания категории для сайта, раздела или площадки; -
1
— временной категории, если разметка аудитории производится с помощью точек учета действия.
В таргетировании по поведению рекламодатель сам регулирует условия, при соблюдении которых разрешен показ рекламного объявления.
Есть два режима соблюдения условий: «верно любое из заданных условий» и «верны все условия». Можно задать до 9 условий, каждое условие состоит из 4-х параметров, где N в названии параметра — номер условия от 1 до 9:
-
размеченные/не размеченные пользователи (
UTNotN
); -
если пользователь размечен, то с какой категорией (
categoryIDN
); -
сколько раз пользователь был размечен (
visitsN
); -
когда пользователь был размечен последний раз (
timeoutN
).
Укажите логику соблюдения условий для показа баннеров рекламной кампании пользователям.
Допустимые значения:
-
0
— верно любое из заданных условий; -
1
— верны все заданные условия.
Выбрать целевую аудиторию: размеченные или не размеченные пользователи, где N в названии параметра — номер условия от 1 до 9.
Допустимые значения:
-
0
— условие не задано; -
1
— размеченные пользователи; -
2
— не размеченные пользователи.
Значение по умолчанию: 0
.
Укажите, с какой категорией должен быть размечен пользователь, где N в названии параметра — номер условия от 1 до 9.
Допустимые значения: идентификатор категории.
Значение по умолчанию: 0
— не задано, если таргетирование проводится на неразмеченных пользователей.
Читайте также:
Укажите, сколько раз пользователь должен быть размечен, где N в названии параметра — номер условия от 1 до 9.
Допустимые значения: целое число от 1 до 2147483647.
Укажите, сколько дней назад пользователь должен быть размечен в последний раз, где N в названии параметра — номер условия от 1 до 9.
Допустимые значения: целое число от 1 до 2147483647.
Посещений не менее заданного числа раз, где N — номер условия.
Допустимые значения: целое число от 1 до 2147483647.
Последнее посещение было не позднее чем заданное число дней назад, где N — номер условия.
Допустимые значения: целое число от 1 до 2147483647.
Обязательный параметр