Загрузка статистики из Яндекс Метрики в МТС DSP: интеграция и файлы
Статистику Яндекс Метрики в МТС DSP можно получать двумя способами: интеграцией по API (доступ к Метрике делегируют на clientstat@mts.ru, в группе включают переключатель «Яндекс Метрика») или загрузкой xlsx-файлов в разделе «Файлы разметки ЯМ». Для обоих нужен макрос `${IMPRESSION_ID}` в utm-метках посадочной страницы. Доступны визиты, отказы, глубина, время на сайте, визиты и доля роботов; данные приходят раз в день за предыдущую дату. Повторно загружать уже загруженные данные нельзя.
Подробности
Интеграция по API
1. Делегировать доступ к статистике Метрики на аккаунт clientstat@mts.ru. 2. В конечной ссылке креатива указать utm_term с набором макросов: `${OFFER_ID}!${BANNER_ID}!${PLATFORM_ID}!${DEVICE}!${TRAFFIC_TYPE}!${DOMAIN}!${SEGMENT_ID}!${IMPRESSION_ID}!${TAGID}!${PUBLISHER_ID}`. 3. В настройках группы, «Медиаплан», включить «Яндекс Метрика»: указать ID счётчика (делегированного на clientstat@mts.ru), значение utm_source, номер позиции макроса `${IMPRESSION_ID}` в utm_term. «Сохранить».
Все креативы кампании должны иметь те же метки, что указаны в поле интеграции. Статистика передаётся раз в день и показывается за предыдущую дату; смотреть можно в статистике кампании и в Конструкторе отчётов. Сейчас по API получаются: визиты, визиты роботов, показатель отказов, глубина, время.
| Название в выгрузке | Метрика | Как считается |
|---|---|---|
| ym_visit | Визиты | суммарное число визитов |
| ym_bounce_visit | Показатель отказов | визиты с одним просмотром страницы меньше 15 секунд; BR = отказные визиты / визиты |
| ym_pages | Глубина просмотра | страницы / визиты |
| ym_seconds | Время на сайте | секунды / визиты |
| ym_robot_visit | Визиты роботов | по поведенческим факторам |
| ym_robot_percentage | Роботность | доля визитов роботов по поведенческим факторам |
Загрузка файлов
Данные привязываются к кампании и видны в Конструкторе отчётов, статистике кампании и группы, списках кампаний и групп. Они же нужны автоматической оптимизации Passing Index: для кампании с загруженными данными система строит более точный прогноз визита.
1. «Файлы разметки ЯМ» > «Загрузить». 2. Выбрать метрики из файла: «Визиты» обязательна, остальные (отказы, глубина, роботность, визиты роботов, время на сайте) выбираются по желанию. Лишние колонки игнорируются, порядок колонок не важен. 3. Указать UTM-метку с макросами и позицию `${IMPRESSION_ID}` (в стандартном наборе — 8, метка — UTM Term). 4. Указать дату данных: один день или последнюю дату периода (для файла с 1 по 11 ноября 2025 — 11.11.2025). 5. Загрузить xlsx (можно несколько файлов сразу). Метрики система берёт из пятой строки, данные — с седьмой.
Статусы файла: «Готово», «Ошибка» (с причиной), «Очередь», «Выполняется». В списке видно число загруженных и распознанных (попадающих в отчёт) строк.
Через API файл загружается методом POST на эндпоинт `/v2/yandexstats`: обязательные параметры imp_id_name (по умолчанию utm_term), imp_id_pos (по умолчанию 8), statistics_date (YYYY-MM-DD), visit и файл в теле запроса в формате XLSX; необязательные bounce_visit, pages, robot_percentage, robot_visit, seconds.
Где смотреть
В Конструкторе отчётов, статистике кампании и группы, списках кампаний и групп: в колонках статистики выбрать метрики с (ym) в названии.
Важно знать
- Повторная загрузка ранее загруженных данных приводит к дублированию и расхождению с Метрикой. Примеры справки: недельный отчёт после дневных файлов, тот же файл с другой датой, период, перекрывающий загруженный.
- В интеграции по API перечислены 5 метрик (визиты, роботы, отказы, глубина, время), а в таблице шесть названий: роботность дана отдельно от визитов роботов.
- Отказ в Метрике: один просмотр страницы и визит короче 15 секунд (по умолчанию; в других системах веб-аналитики условия могут быть другими).