targetingTime

Таргетировать баннер по времени.

Таргетирование по времени позволяет ограничить показы кампании определенными днями недели или временем суток, в том числе с учетом часового пояса посетителя сайта.

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

https://adfox.yandex.ru/api/v1
  ? object=banner
  & action=target
  & actionObject=targetingTime
  & objectID=<integer>
  & isRedefined=<integer>
  & [mode=<integer>]
  & [hourNdayM=<integer>]
  & [dayN=<integer>]

objectID*

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

isRedefined*

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

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

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

    • кампания;
    • размещение кампании на сайте;
    • размещение кампании на разделе сайта;
    • размещение кампании на площадке;
    • баннер.

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

mode

Режим таргетирования: по дням недели или по дням месяца.

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

  • 0 — по дням недели;
  • 1 — по дням месяца.

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

hourNdayM

Включить таргетирование по дням недели/часам, где:

  • N — час от 0 до 23 (например: 0 — с 00:00 до 00:59, 1 — с 01:00 до 01:59 и т. д.);
  • M — день недели с 1 до 7 (например: 1 — понедельник, 2 — вторник, 3 — среда и т. д.).

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

  • 0 — выключено;
  • 1 — включено.

dayN

Включить таргетирование по дням месяца, где N — номер дня месяца (например: 1 — первое число месяца, 2 — второе число месяца и т. д.).

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

  • 0 — выключено;
  • 1 — включено.

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

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

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

code

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

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

Запрос:

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

Ответ:

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

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

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

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

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

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

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

    • кампания;
    • размещение кампании на сайте;
    • размещение кампании на разделе сайта;
    • размещение кампании на площадке;
    • баннер.

  • 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 — включено.

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

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