TD API 2.0 - Getting creatives info

Просмотр информации о креативе

📘

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

https://tdm4.adcloud.org/api/v2/?method=MethodName

В качестве get-параметра необходимо передавать название метода, что позволит динамически определить метод через URL-строку.

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

Просмотр креатива

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

Пример запроса:

JSON

{
  "jsonrpc": "2.0",
  "method": "Creative.getInfo",
  "params": {
    "xxhash": "45DF453F452C455F"
  },
  "id": 1
}

Пример ответа для креатива типа "Video":

JSON

{
    "jsonrpc": "2.0",
    "result": {
        "data": {
            "video_type": "inline",
            "duration": 64.098,
            "skip_duration": 5,
            "video_url": "https://cdn3.terratraf.io/20241127/929a54fcd95e38b98ee1e8c96a468b19/3b74815a159ca9056b18c0e4f4b555c6.mp4",
            "video_bitrate": 3564,
            "description": "Mediasniper. Programmatic powerhouse",
            "use_vpaid": true,
            "audit": {
                "show": "",
                "show2": "",
            },
            "file_size": 27,
            "video_poster_url": "https://cdn3.terratraf.io/20241127/929a54fcd95e38b98ee1e8c96a468b19/3b74815a159ca9056b18c0e4f4b555c6_preview.jpg"
        },
        "size": "1920x1080",
        "language": "ru",
        "title": "Видео MP4",
        "xxhash": "45DF453F452C455F",
        "internal_id": "tdmdev#1234.2.2",
        "type": "VIDEO_INLINE",
        "status": "STOPPED",
        "link": "https://mediasniper.ru/?&s_trk={TR_KEY}",
        "extension_link": "https://mediasniper.ru/2",
        "adomain": "https://mediasniper.ru/",
        "date_create": {
            "date": "2024-11-27 14:15:46.000000",
            "timezone_type": 3,
            "timezone": "Europe/Moscow"
        },
        "date_edit": {
            "date": "2024-11-27 14:16:10.000000",
            "timezone_type": 3,
            "timezone": "Europe/Moscow"
        },
        "advertiser_name": "mediasniper",
        "uuid": "f23f23f2-f235-4555-999f-f23476f2377d",
        "status_creative_ord": "SUCCESS",
        "erid": "LjN888JGQ",
        "kktu_codes": "30.10.1"
    },
    "id": 1

}

Метод возвращает в секции результатов данные по запрашиваемому креативу, содержащие следующие параметры:

Поле	Описание	Пример значения
internal_id	Внутренний ID креатива	tdmdev#1234.2.2
date_create	Структура, содержащая дату создания креатива и его таймзону.	{ "date": "2024-11-27 11:49:15.000000", "timezone_type": 3, "timezone": "Europe/Moscow" }
date_edit	Структура, содержащая дату последнего редактирования креатива и его таймзону.	{ "date": "2024-11-27 11:49:15.000000", "timezone_type": 3, "timezone": "Europe/Moscow" }
audit	Структура, содержащая следующие данные: show - ссылка на пиксель аудита, show2 - ссылка на дополнительный пиксель аудита.	{ "show": "", "show2": "" }
file_size	Разрешение видео	27
video_poster_ur	Ссылка на постер видео	<https://cdn3.terratraf.io/20241127/929....jpg>
use_vpaid	Для видео mp4, "Использовать VPAID" необходимо включить для отображения ID ЕРИР в видео-рекламе. Подробнее по ссылке	true
extension_link	Дополнительная ссылка для перехода	https://mediasniper.ru/2
uuid	Идентификатор креатива в платформе ОРД	f23f23f2-f235-4555-999f-f23476f2377d
erid	Идентификатор рекламы - уникальный код, присваиваемый в системе ЕРИР	LjN888JGQ
kktu_codes	Код классификатора товарных категорий	30.10.1
status_creative_ord	Статус отправки в ЕРИР, возможные значения: PENDING - в процесс, SUCCESS - успешно.	SUCCESS