СтатьиDiscussions
Статьи

TD API 2.0 - Adding creative

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

Suggest Edits

📘

Адрес для отправки запросов:

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строкадаСтрока в формате URL
Параметр обязателен для ротации!
video_bitrateчислонетБитрейт видео. Значение можно найти в свойствах видео.
Параметр обязателен для ротации!
descriptionстрокадаОбщее описание объекта рекламирования.
Укажите:
· Бренд (или несколько брендов) рекламируемых товаров или услуг;
· Вид товара/услуги;
· Дополнительную информацию.
Длина строки больше 0 и меньше 1024 символов.
Параметр обязателен для ротации!
use_vpaidbooleanдаДля видео mp4, "Использовать VPAID" необходимо включить для отображения ID ЕРИР в видео-рекламе. Подробнее по ссылке
Важно: для ротации необходимо установить флаг в значение true
auditструктуранетСтруктура, содержащая следующие данные:
show - ссылка на пиксель аудита,
show2 - ссылка на дополнительный пиксель аудита.
extension_linkстроканетДополнительная ссылка перехода

Video VAST

ПараметрТипОбязательный?Описание
durationчислонетПродолжительность видео, может принимать значение больше 0, но меньше 300.
Параметр обязателен для ротации!
skip_durationчислонетПродолжительность для пропуска видео, может принимать значение больше 0, но меньше 300.
Параметр обязателен для ротации!
vast_urlстрокадаСтрока в формате URL
Параметр обязателен для ротации!
descriptionстрокадаОбщее описание объекта рекламирования.
Укажите:
· Бренд (или несколько брендов) рекламируемых товаров или услуг;
· Вид товара/услуги;
· Дополнительную информацию.
Длина строки больше 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",
      "kktu_codes": "30.10.1",
      "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://mediasniper2.ru"
            }
        }
    }
  },
  "id": 1
}

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

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

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

{
    "id": 1,
    "method": "Creative.add",
    "jsonrpc": "2.0",
    "params": {
        "object": {
            "campaign_xxhash": "81X6CADFE205TEST",
            "type": "VIDEO_INLINE",
            "title": "Видео",
            "status": "STOPPED",
            "advertiser_name": "Mediasniper",
            "data": {
                "description": "Mediasniper. Programmatic powerhouse.",
                "video_url": "https://cdn3.terratraf.io/20241008/f5ae7459c6b48efd8eb4695d797d7a8c/2f7089fc4450e7804c3b587853821a9b.mp4",
                "duration":13,
                "skip_duration":12,
                "video_bitrate": 1954,
                "use_vpaid": true
            },
            "adomain": "https://mediasniper.ru",
            "link": "https://mediasniper.ru/?us_trk={TR_KEY}",
            "kktu_codes": "30.10.1",
            "language": "ru",
                        "categories": {
                "iab": "3-1"
            },
            "size":"1920x1080"
        }
    }
}

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

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

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

Updated about 1 month ago