targetingKeywords
Таргетировать баннер по ключевым словам или фразам.
Таргетирование по ключевым словам или фразам позволяет настроить передачу слов или фраз в запрос за баннером и использовать их для таргетирования рекламных кампаний и баннеров. Таргетирование по ключевым словам подойдет для случаев, когда список ключевых слов заранее неизвестен. Например, в качестве ключевой фразы могут быть быть использованы поисковые фразы, введенные пользователями на сайте.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=banner
& action=target
& actionObject=targetingKeywords
& objectID=<integer>
& isRedefined=<integer>
& [keywordsLogic=<integer>]
& [keywords=<string>]
& [keywordsNotAllowed=<string>]
|
ID объекта, над которым производится действие. |
|
Переопределить таргетирование. Возможные значения:
|
|
Способ таргетирования. Допустимые значения:
Значение по умолчанию: |
|
Укажите ключевую фразу или слова, на которые будет старгетирован объект. Одновременно таргетировать и на фразы, и на слова нельзя. Формат записи:
Может содержать русские и латинские буквы, цифры и любые символы. |
|
Ключевая фраза или слова, которые не должны присутствовать в запросе за баннером, чтобы баннер был показан. Формат записи:
Может содержать русские и латинские буквы, цифры и любые символы. |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
</status>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=banner&action=target&actionObject=targetingKeywords&objectID=474205&isRedefined=1
Ответ:
<response> <status> <code>0</code> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом banner
:
- получить список баннеров;
- добавить баннер;
- редактировать баннер;
- получить сводную информацию по таргетированию на уровне баннера;
- получить информацию о размещении баннера;
- получить статистику по кампаниям/баннерам/площадкам за день;
- таргетировать баннер по географии;
- таргетировать баннер по URL;
- таргетировать баннер по частоте;
- таргетировать баннер по полу, возрасту, доходу;
- таргетировать баннер по пользовательским характеристикам;
- таргетировать баннер по времени.
ID объекта, над которым производится действие.
Переопределить таргетирование.
Возможные значения:
-
0
— наследовать настройки таргетирования, установленные на уровне выше. Иерархия уровней от верхнего к нижнему:-
кампания;
-
размещение кампании на сайте;
-
размещение кампании на разделе сайта;
-
размещение кампании на площадке;
-
баннер.
-
-
1
— отменить настройки таргетирования на более высоких уровнях и использовать настройки, установленные на текущем уровне.
Способ таргетирования.
Допустимые значения:
-
0
— по словам; -
1
— по фразам.
Значение по умолчанию: 0
.
Укажите ключевую фразу или слова, на которые будет старгетирован объект.
Одновременно таргетировать и на фразы, и на слова нельзя.
Формат записи:
-
разделитель фраз — запятая;
-
разделитель слов — пробел или запятая.
Может содержать русские и латинские буквы, цифры и любые символы.
Ключевая фраза или слова, которые не должны присутствовать в запросе за баннером, чтобы баннер был показан.
Формат записи:
-
разделитель фраз — запятая;
-
разделитель слов — пробел или запятая.
Может содержать русские и латинские буквы, цифры и любые символы.
Обязательный параметр