banner
Склонировать баннер.
Новый баннер создается в результате клонирования, и может унаследовать от исходного баннера разный набор параметров:
- только параметры баннера;
- параметры баннера и размещение;
- параметры баннера, размещение и таргетирование;
- параметры баннера, размещение и таргетирование и настройки ограничений по показам и переходам.
Отличия нового баннера от баннера-родителя:
- дата начала устанавливается на дату клонирования;
- дата окончания сбрасывается;
- статистика не копируется.
Формат запроса
https://adfox.yandex.ru/api/v1
? object=campaign
& action=clone
& actionObject=banner
& objectID=<integer>
& listIDs=<integer>
& targetCampaignID=<integer>
& cloneTypeID=<integer>
& [name{BANNERID}=<string>]
|
ID кампании, из которой необходимо склонировать баннер. |
|
ID баннера, который нужно склонировать. Для передачи списка ID объектов используйте разделитель — запятую. |
|
ID кампании, в которую баннер будет склонирован. Читайте также: |
|
Тип клонирования объекта. Допустимые значения:
|
|
В названии параметра {BANNERID} — идентификатор исходного баннера, а значение параметра — название нового баннера. Если название не передано, то новому баннеру будет присвоено название исходного баннера. При клонировании нескольких баннеров передавайте для каждого нового баннера свой параметр Например: name1111=clone1&name1112=clone2 |
* Обязательный параметр
Формат ответа
<response>
<status>
<code>{integer}</code>
<ID>{integer}</ID>
</status>
</response>
Параметры ответа
|
Статус обработки запроса. Значение |
|
Идентификатор нового баннера. |
|
При клонировании нескольких баннеров, часть из которых создана с шаблонами, не поддерживающими работу на кодах с загрузчиком, будут скопированы только баннеры с шаблонами, имеющими в названии тег [context], а остальные проигнорированы. Наличие тега Чтобы проверить, поддерживает ли шаблон работу на кодах вставки загрузчиком, воспользуйтесь методом получения данных о шаблоне. Параметр |
Пример запроса и ответа
Запрос:
https://adfox.yandex.ru/api/v1?object=campaign&action=clone&actionObject=banner&objectID=562830&listIDs=1642949,1642950&targetCampaignID=562831&cloneTypeID=3&name1642949=clone1&name1642950=clone2
Ответ:
<response> <status> <code>0</code> <ID>4235079,4235080</ID> </status> </response>
Другие действия с объектом
Читайте также о других действиях с объектом campaign
:
- добавить кампанию
- получить список кампаний;
- удалить кампанию;
- редактировать кампанию;
- получить список баннеров рекламной кампании;
- разместить кампанию на сайте, разделе, площадке.
ID кампании, из которой необходимо склонировать баннер.
ID баннера, который нужно склонировать.
Для передачи списка ID объектов используйте разделитель — запятую.
ID кампании, в которую баннер будет склонирован.
Читайте также:
Тип клонирования объекта.
Допустимые значения:
-
0
— клонируется только содержимое баннера. Остальные настройки сбрасываются и будут унаследованы от кампании; -
1
— клонируется содержимое баннера и настройки размещения. Остальные настройки сбрасываются и будут унаследованы от кампании; -
2
— клонируется содержимое баннера, настройки размещения и таргетирования. Ограничения по показам и переходам сбрасываются и будут унаследованы от кампании; -
3
— клонируется содержимое баннера, настройки размещения, таргетирования и ограничения.
В названии параметра {BANNERID} — идентификатор исходного баннера, а значение параметра — название нового баннера.
Если название не передано, то новому баннеру будет присвоено название исходного баннера.
При клонировании нескольких баннеров передавайте для каждого нового баннера свой параметр name{BANNERID}
.
Например: name1111=clone1&name1112=clone2
Обязательный параметр