targetingTime

Таргетировать размещение кампании на площадке по времени.

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

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

https://api.adfox.ru/v1/API.php
 ? loginAccount=<string>
 & loginPassword=<string>
 & object=campaign
 & action=targetPlace
 & actionObject=targetingTime
 & objectID=<integer>
 & placeID=<integer>
 & isRedefined=<integer>
 & [impressionsPerN=<integer>]
 & [impressionsPerNPerHour=<integer>]
 & [isClientTime=<integer>]
 & [mode=<integer>]
 & [hourNdayM=<integer>]
 & [dayN=<integer>]
Query-параметры
objectID *ID объекта, над которым производится действие.
placeID *

ID площадки.

isRedefined *

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

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

  • 0 — наследовать настройки таргетирования, установленные на уровне выше. Иерархия уровней от верхнего к нижнему:
    • кампания;
    • размещение кампании на сайте;
    • размещение кампании на разделе сайта;
    • размещение кампании на площадке;
    • баннер.
  • 1 — отменить настройки таргетирования на более высоких уровнях и использовать настройки, установленные на текущем уровне.
impressionsPerNОбщее количество показов в сутки, где N — номер дня:
  • 1 — понедельник;
  • 2 — вторник;
  • 3 — среда;
  • 4 — четверг;
  • 5 — пятница;
  • 6 — суббота;
  • 7 — воскресенье.

Значение параметра — число показов от 1 до 2147483647.

Например, 10 показов во вторник: impressionsPer2=10.

impressionsPerNPerHourОбщее количество показов в час, где N — номер дня:
  • 1 — понедельник;
  • 2 — вторник;
  • 3 — среда;
  • 4 — четверг;
  • 5 — пятница;
  • 6 — суббота;
  • 7 — воскресенье.

Значение параметра — число показов от 1 до 2147483647.

Например, 10 показов в час по вторникам: impressionsPer2PerHour=10.

isClientTime

Использовать время посетителя сайта. Таргетирование будет производиться по часовому поясу пользователя. Вся статистика будет отображаться по часовому поясу GMT+3:00.

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

  • 0 — использовать время GMT+3:00;
  • 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

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

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

Запрос:

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

Ответ:

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

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

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