targetingTime
Таргетировать размещение кампании на площадке по времени.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=campaign
& action=targetPlace
& actionObject=targetingTime
& objectID=<integer>
& placeID=<integer>
& isRedefined=<integer>
& [impressionsPerN=<integer>]
& [impressionsPerNPerHour=<integer>]
& [isClientTime=<integer>]
& [mode=<integer>]
& [hourNdayM=<integer>]
& [dayN=<integer>]
|
ID объекта, над которым производится действие. |
|
ID площадки. |
|
Переопределить таргетирование. Возможные значения:
|
|
Общее количество показов в сутки, где N — номер дня:
Значение параметра — число показов от 1 до 2147483647. Например, 10 показов во вторник: impressionsPer2=10. |
|
Общее количество показов в час, где N — номер дня:
Значение параметра — число показов от 1 до 2147483647. Например, 10 показов в час по вторникам: impressionsPer2PerHour=10. |
|
Использовать время посетителя сайта. Таргетирование будет производиться по часовому поясу пользователя. Вся статистика будет отображаться по часовому поясу GMT+3:00. Допустимые значения:
|
|
Режим таргетирования: по дням недели или по дням месяца. Допустимые значения:
Значение по умолчанию: |
|
Включить таргетирование по дням недели/часам, где:
Допустимые значения:
|
|
Включить таргетирование по дням месяца, где N — номер дня месяца, например: Допустимые значения:
|
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=campaign&action=targetPlace&actionObject=targetingTime&objectID=474205&placeID=345&isRedefined=1
Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом campaign
:
- добавить кампанию
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- получить список баннеров рекламной кампании;
- разместить кампанию на сайте, разделе, площадке.
ID объекта, над которым производится действие.
ID площадки.
Переопределить таргетирование.
Возможные значения:
-
0
— наследовать настройки таргетирования, установленные на уровне выше. Иерархия уровней от верхнего к нижнему:-
кампания;
-
размещение кампании на сайте;
-
размещение кампании на разделе сайта;
-
размещение кампании на площадке;
-
баннер.
-
-
1
— отменить настройки таргетирования на более высоких уровнях и использовать настройки, установленные на текущем уровне.
Общее количество показов в сутки, где N — номер дня:
-
1
— понедельник; -
2
— вторник; -
3
— среда; -
4
— четверг; -
5
— пятница; -
6
— суббота; -
7
— воскресенье.
Значение параметра — число показов от 1 до 2147483647.
Например, 10 показов во вторник: impressionsPer2=10.
Общее количество показов в час, где N — номер дня:
-
1
— понедельник; -
2
— вторник; -
3
— среда; -
4
— четверг; -
5
— пятница; -
6
— суббота; -
7
— воскресенье.
Значение параметра — число показов от 1 до 2147483647.
Например, 10 показов в час по вторникам: impressionsPer2PerHour=10.
Использовать время посетителя сайта. Таргетирование будет производиться по часовому поясу пользователя. Вся статистика будет отображаться по часовому поясу GMT+3:00.
Допустимые значения:
-
0
— использовать время GMT+3:00; -
1
— использовать время посетителя сайта.
Режим таргетирования: по дням недели или по дням месяца.
Допустимые значения:
-
0
— по дням недели; -
1
— по дням месяца.
Значение по умолчанию: 0
.
Включить таргетирование по дням недели/часам, где:
-
N
— час от 0 до 23, например:0
— с 00:00 до 00:59,1
— с 01:00 до 01:59 и т.д.; -
M
— день недели с 1 до 7, например:1
— понедельник, 2 — вторник, 3 — среда и т.д.
Допустимые значения:
-
0
— выключить; -
1
— включить.
Включить таргетирование по дням месяца, где N — номер дня месяца, например: 1
— первое число месяца, 2 — второе число месяца и т.д.
Допустимые значения:
-
0
— выключить; -
1
— включить.
Обязательный параметр