targetingURL
Таргетировать баннер по URL.
Этот вид таргетирования будет удобен, если показ рекламы необходимо произвести по определенному списку страниц сайта или же запретить показ на отдельных страницах.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=banner
& action=target
& actionObject=targetingURL
& objectID=<integer>
& isRedefined=<integer>
& [templateType=<integer>]
& [targetingUrlOn[]=<string>]
& [targetingUrlOff[]=<string>]
|
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=banner&action=target&actionObject=targetingURL&objectID=474205&isRedefined=1&templateType=0&targetingUrlOn[]=*site.ru/&targetingUrlOn[]=*site.ru/*&targetingUrlOff[]=https://www.demo.site.ru/*
Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом banner
:
- получить список баннеров;
- добавить баннер;
- редактировать баннер;
- получить сводную информацию по таргетированию на уровне баннера;
- получить информацию о размещении баннера;
- получить статистику по кампаниям/баннерам/площадкам за день;
- таргетировать баннер по частоте;
- таргетировать баннер по географии;
- таргетировать баннер по ключевым словам;
- таргетировать баннер по полу, возрасту, доходу;
- таргетировать баннер по пользовательским характеристикам;
- таргетировать баннер по времени.
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...
Обязательный параметр