targetingURL
Таргетировать размещение кампании на разделе сайта по URL.
Этот вид таргетирования будет удобен, если показ рекламы необходимо произвести по определенному списку страниц сайта или же запретить показ на отдельных страницах.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=campaign
& action=targetZone
& actionObject=targetingURL
& objectID=<integer>
& zoneID=<integer>
& isRedefined=<integer>
& [templateType=<integer>]
& [targetingUrlOn[]=<string>]
& [targetingUrlOff[]=<string>]
|
ID объекта, над которым производится действие. |
|
ID раздела сайта. |
|
Переопределить таргетирование. Возможные значения:
|
|
Тип шаблона для таргетирования по URL. Допустимые значения:
Значение по умолчанию: |
|
URL страницы, на которой разрешен показ. Если URL несколько, то каждый URL надо передавать в отдельном параметре. Максимальное количество параметров с URL — 5. Пример записи:
|
|
URL страницы, на которой запрещен показ. Если URL несколько, то каждый URL надо передавать в отдельном параметре. Максимальное количество параметров с URL — 5. Пример записи:
|
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=campaign&action=targetZone&actionObject=targetingURL&objectID=474205&zoneID=321&isRedefined=1&templateType=0&targetingUrlOn[]=*site.ru/&targetingUrlOn[]=*site.ru/*&targetingUrlOff[]=https://www.demo.site.ru/*
Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом campaign
:
- добавить кампанию
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- получить список баннеров рекламной кампании;
- разместить кампанию на сайте, разделе, площадке.
ID объекта, над которым производится действие.
ID раздела сайта.
Переопределить таргетирование.
Возможные значения:
-
0
— наследовать настройки таргетирования, установленные на уровне выше. Иерархия уровней от верхнего к нижнему:-
кампания;
-
размещение кампании на сайте;
-
размещение кампании на разделе сайта;
-
размещение кампании на площадке;
-
баннер.
-
-
1
— отменить настройки таргетирования на более высоких уровнях и использовать настройки, установленные на текущем уровне.
Тип шаблона для таргетирования по URL.
Допустимые значения:
-
0
— стандартный. В шаблоне URL используйте символ*
для обозначения последовательности любых символов любой длины. -
1
— POSIX. В шаблоне URL используйте регулярные выражения по стандарту POSIX.
Значение по умолчанию: 0
.
URL страницы, на которой разрешен показ.
Если URL несколько, то каждый URL надо передавать в отдельном параметре. Максимальное количество параметров с URL — 5.
Пример записи:
targetingUrlOn[]=url1&targetingUrlOn[]=url2...
URL страницы, на которой запрещен показ.
Если URL несколько, то каждый URL надо передавать в отдельном параметре. Максимальное количество параметров с URL — 5.
Пример записи:
targetingUrlOff[]=url1&targetingUrlOff[]=url2...
Обязательный параметр