Конструктор отчётов и 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 в справке не приведены.