Добавление креатива в рекламную кампанию

Метод позволяет добавить креатив в кампанию.

info

Адрес для отправки запросов https://tdm4.adcloud.org/api/v2/?method=MethodName В качестве get-параметра необходимо передавать название метода, что позволит динамически определить метод через URL-строку.

За предоставлением доступа к методу обратитесь к администратору.

Добавление креатива

method": "Creative.add" позволяет пользователю добавить креатив в рекламную кампанию. Для этого необходимо выполнить запрос, указав в качестве параметров "campaign_xxhash" - xxhash кампании и параметры нового креатива.

Общие параметры креатива:

Параметр	Тип	Обязательный?	Описание
campaign_xxhash	строка	да	ID кампании
type	строка	да	Тип креатива. Возможные значения: "VIDEO_INLINE", "VIDEO_VAST"
title	строка	да	Заголовок креатива. Длина строки: больше 0, но не больше 150 символов
status	строка	нет	Статус креатива. Допустимые значения: "STOPPED", "LAUNCHED", "DELETED", "ARCHIVE"
advertiser_name	строка	нет	Имя рекламодателя
language	строка	нет	Код языка ISO_639-1. По умолчанию “RU”
categories	объект	нет	Категоризация креатива
iab	строка	нет	Категория IAB-каталога первой версии. Допустимые символы: 0-9 и “-”. По умолчанию “24”
size	строка	да	Размер креатива. Например"size": "240x400", где 240- Ширина креатива, 400 - Высота креатива. Число должно быть больше 0, но не больше 10000. Параметр обязателен для ротации!
link	строка	нет	Кликовая ссылка. Длина строки: больше 0, но не больше 1024 символов. Строка должна иметь формат ссылки. Параметр обязателен для ротации!
kktu_codes	строка	да	Код классификатора товарных категорий.
adomain	строка	нет	Конечный URL. Длина строки: больше 0, но не больше 128 символов. Параметр обязателен для ротации!
data	объект	нет	Объект с данными согласно типу креатива.

Дополнительные параметры по типам креативов:

Для разных типов креативов есть дополнительные параметры:

Video

Параметр	Тип	Обязательный?	Описание
duration	число	нет	Продолжительность видео, может принимать значение больше 0, но меньше 300. Параметр обязателен для ротации!
skip_duration	число	нет	Продолжительность для пропуска видео, может принимать значение больше 0, но меньше 180. Параметр обязателен для ротации!
video_url	строка	да	Ссылка на видеоролик. Параметр обязателен для ротации!
video_bitrate	число	нет	Битрейт видео. Параметр обязателен для ротации!
description	строка	да	Общее описание объекта рекламирования. Укажите: 1. Бренд (или несколько брендов) рекламируемых товаров или услуг; 2. Вид товара/услуги; 3. Дополнительную информацию. Длина строки больше 0 и меньше 1024 символов. Параметр обязателен для ротации!
use_vpaid	boolean	да	Для видео mp4, "Использовать VPAID" необходимо включить для отображения ID ЕРИР в видео-рекламе. Важно: для ротации необходимо установить флаг в значение true
audit	структура	нет	Структура, содержащая следующие данные: show - ссылка на пиксель аудита, show2 - ссылка на дополнительный пиксель аудита.
extension_link	строка	нет	Дополнительная ссылка перехода

Video VAST

Параметр	Тип	Обязательный?	Описание
duration	число	нет	Продолжительность видео, может принимать значение больше 0, но меньше 300. Параметр обязателен для ротации!
skip_duration	число	нет	Продолжительность для пропуска видео, может принимать значение больше 0, но меньше 300. Параметр обязателен для ротации!
vast_url	строка	да	Строка в формате URL. Параметр обязателен для ротации!
description	строка	да	Общее описание объекта рекламирования. Укажите: 1. Бренд (или несколько брендов) рекламируемых товаров или услуг; 2. Вид товара/услуги; 3. Дополнительную информацию. Длина строки больше 0 и меньше 1024 символов. Параметр обязателен для ротации!
audit	структура	нет	Структура, содержащая следующие данные: show - ссылка на пиксель аудита, show2 - ссылка на дополнительный пиксель аудита.
extension_link	строка	нет	Дополнительная ссылка перехода

Пример запроса для типа креатива VIDEO_VAST:

{
  "jsonrpc": "2.0",
  "method": "Creative.add",
  "params": {
    "object": {
      "campaign_xxhash": "5FBABBBF26444466",
      "status": "STOPPED",
      "title": "test api 12",
      "type": "VIDEO_VAST",
      "adomain": "https://mediasniper.ru/",
      "link": "https://mediasniper.ru/?us_trk={TR_KEY}",
      "extension_link": "https://mediasniper.ru/2",
      "advertiser_name": "advertiser_name",
      "size": "240x400",
      "data": {
        "vast_url":"https://cdn3.terratraf.io/315fd1ab17f8b6ed59fd0ce2b290766b.xml",
        "skip_duration": 5,
        "description": "mediasniper description",
         "audit": {
                "show": "https://mediasniper.ru",
                "show2": "https://mediasniper.ru"
            }
        }
    }
  },
  "id": 1
}

Пример ответа:

{
    "jsonrpc": "2.0",
    "result": {
        "id": "7171A571A571A5A5"
    },
    "id": 1
}

Пример запроса для типа креатива VIDEO:

{
    "id": 1,
    "method": "Creative.add",
    "jsonrpc": "2.0",
    "params": {
        "object": {
            "campaign_xxhash": "A18282F60B444444",
            "type": "VIDEO_INLINE",
            "title": "Видео VIDEO_INLINE",
            "status": "STOPPED",
            "advertiser_name": "advertiser_name",
            "data": {
                "description": "description creative",
                "video_url": "https://cdn3.terratraf.io/d0ce2b290766b.mp4",
                "duration":30,
                "skip_duration":5,
                "video_bitrate": 8085,
                "use_vpaid": true,
                "audit": {
                        "show": "https://mediasniper.ru",
                        "show2": "https://mediasniper.ru"
            }
            },
            "adomain": "https://mediasniper.ru",
            "link": "https://mediasniper.ru/?s_trk={TR_KEY}",
            "extension_link": "https://mediasniper.ru/2",
            "language": "de",
                        "categories": {
                "iab": "1"
            },
            "size":"1920x1080"
        }
    }
}

Пример ответа:

{
    "jsonrpc": "2.0",
    "result": {
        "id": "7272A672A672A6A6"
    },
    "id": 1
}

Метод возвращает в секции результатов ID созданного креатива.