Конструктор отчётов и API в МТС DSP

Конструктор отчётов (ui.rtb.mts.ru, раздел reports-constructor) строит сложные выгрузки по нескольким кампаниям, группам или всему кабинету в XLSX и CSV; формируется отчёт не дольше 2 часов. API МТС DSP бесплатный, даёт те же операции, что кабинет, лимит 60 запросов в минуту (при превышении код 429). Токен создаётся в разделе «API токены», методы тестируются в «API swagger».

Подробности

Как построить отчёт

1. Задать период. 2. Добавить фильтры (можно несколько, у каждого несколько значений). 3. Выбрать колонки группировки и колонки статистики. Порядок выбора не влияет: колонки выстраиваются в заданном системой порядке. 4. Ввести название отчёта, нажать «Создать xlsx» или «Создать csv».

Отчёт появляется в списке со статусом «Выполняется»; статус обновляется только перезагрузкой страницы. Если за 2 часа не сформировался, статус «Ошибка». Готовый файл скачивается по ссылке в колонке «Результат». Детальные данные (например, по домену или TagID) выгружают за небольшой период.

Действия с отчётом (при наведении на название): удалить, обновить (подгрузятся свежие данные), копировать (колонки группировки, фильтры, колонки статистики и период переносятся в форму).

Данные Конструктора и статистики внутри кампании могут немного отличаться из-за разных источников. Для закрытия справка рекомендует статистику кампании или список всех кампаний.

Примеры

  • Пересечённый охват: фильтры по нужным кампаниям или группам, колонка группировки, которая даёт одну строку (для одной группы «Группа кампаний», для кампаний вне группы рекламодатель или месяц), в статистике «Охват».
  • Статистика по атрибутам ОРД: настраивается в разрезе ЕРИР ID или изначальных договоров.
  • Срезы для оптимизации, недоступные в статистике кампании: сделки, TagID, браузеры, ОС, форматы In-Stream (pre-roll, post-roll и др.). Пример: выгрузка по «ID Плейса / TagID» позволяет запрещать отдельные плейсменты с плохими показателями, а не всю крупную площадку; ID с аномалиями вносят в список типа TagID.

Отчёты по API

Сформировать отчёт в интерфейсе, открыть «Код запроса», использовать его в методе `/reports/add`; скачивать отчёт методом `/reports/download/{id}?ext=xlsx`.

API МТС DSP

  • Программный доступ к статистике и настройкам кампаний, те же операции, что в кабинете. Чаще всего используется для отправки статистики в BI.
  • Бесплатно и без дополнительных разрешений; нужен доступ к кабинету по номеру телефона. Рекламодателю доступ даёт агентство.
  • Работа: войти в кабинет, в «API токены» сгенерировать токен, в «API swagger» нажать Authorize, выбрать метод, «Try it out», задать параметры, «Execute», проверить ответ и скопировать запрос в свою систему.
  • Лимит 60 запросов в минуту, при превышении код 429. Вопросы — на support_ss@mts.ru.

Важно знать

  • Рекламодателю раздел API swagger доступен в кабинете, но токен и доступ он получает через агентство.
  • Статистика пикселя в Конструкторе совпадает с кампанией только при той же модели атрибуции (подробности в статье про универсальный пиксель).
  • Лимиты на размер выгрузки по строкам и список всех методов API в справке не приведены.