В этой статье вы узнаете, как коннектор Яндекс Метрика Logs API выгружает данные в хранилище ROMI center: что попадает в таблицу, с какой периодичностью идёт выгрузка и как устроена перезагрузка. Полный список полей — в статье Яндекс Метрика Logs API: описание выгружаемых полей.
Примечание
Это отдельный источник от коннектора «Яндекс Метрика» с отчётами (визиты, расходы, цели в агрегированном виде) — у него свои таблицы и свой документ. Передача офлайн-конверсий в Метрику — тоже другой поток.
Что выгружается: визиты, по строке на визит
Коннектор забирает у Метрики сырые логи визитов — не отчёты с суммами, а по строке на каждый визит со всеми выбранными полями. Все поля ложатся в одну таблицу подключения. При подключении выбирается один счётчик; для другого заводится отдельное подключение со своей таблицей. Поля отмечаются на шаге «Выбор полей»: в списке 134 поля, 11 из них обязательные.
Важно
Поле «Адрес страницы (все страницы визита)» устроено иначе: в логе визитов Метрика его не отдаёт. Коннектор делает вторую выгрузку — лог событий, собирает адреса всех просмотров визита по порядку и кладёт их массивом в колонку PageURLs. Поле работает только за даты с 10.10.2025 и только в хранилище на ClickHouse. Второй лог расходует квоту счётчика.
Периодичность
Каждый день в 05:00 коннектор ставит новые дни в очередь, заказывает логи в Метрике (не больше 10 дней одновременно в работе на счётчик) и каждые 5 минут скачивает готовые, записывая их в хранилище.
Важно
Метрика ограничивает объём логов счётчика — готовых и ещё готовящихся — 10 ГБ, и в этот лимит входят логи, которые счётчику заказывают другие сервисы. После записи дня коннектор удаляет его логи в Метрике, чтобы освободить место. Если места нет, день ждёт и повторяет попытку — предел ожидания 70 часов с момента постановки в очередь, после чего день помечается ошибкой.
Примечание
«Приостановить выгрузку» не действует: подключение на паузе продолжает выгружаться каждый день.
За какой период забираются данные
Ежедневная выгрузка берёт дни со дня после последнего уже поставленного по вчерашний день включительно. Первое сохранение подключения сразу забирает последние семь дней. Историческая перезагрузка — выбранный период, по одному дню.
Важно
Сегодняшний день не выгружается никогда: Logs API отдаёт только завершённые сутки. Упавший день может не вернуться сам — ежедневная выгрузка идёт вперёд и к пропускам позади себя не возвращается. Надёжный способ вернуть пропуск — историческая перезагрузка за этот период.
Как сохраняет данные
- Куда: хранилище ROMI center на движке ClickHouse.
- Имя таблицы:
ym_sessions_<номер счётчика>_<id подключения>. - День перезаписывается целиком. Перед записью дня из таблицы удаляются все строки с этой датой, затем день вставляется заново. Повторная загрузка дня визиты не задваивает.
- Структура таблицы: движок
MergeTree, сортировка поVisitID, без разбиения на партиции. - Структура догоняется, а не пересоздаётся. Поле, отмеченное в настройках, приходит новой колонкой. Колонки никогда не удаляются: снятое поле останется в таблице со старыми значениями, а новые строки будут писаться в него пустыми.
- Правка настроек посреди долгой выгрузки попадает только в дни, лог которых Метрика начала готовить после правки. У дней, заказанных раньше, новые колонки останутся пустыми.
Перезагрузка данных
Автоматической перезаписи прошлых дней у Logs API нет: ежедневная выгрузка ставит только новые дни, а уже загруженный день повторно не читает. Функция «Загрузить исторические данные» в меню подключения работает за любой период по вчерашний день, по одному дню — перечитывается весь период, в том числе уже загруженные дни, без дублей.
Важно
Галочка «Удалить ранее загруженные данные за период» удаляет таблицу подключения целиком, а не только выбранный период, и затем грузит все дни периода. После такой перезагрузки в таблице останется только перезагруженный период.
Примечание
Пока предыдущая историческая выгрузка не закончилась, новую запустить нельзя — кабинет ответит «Выгрузка уже запущена. Дождитесь окончания.» Ежедневная выгрузка запуску не мешает.
Дополнительные настройки
| Настройка | Что делает |
|---|---|
| Счётчик | Выбирается при подключении, один на подключение, и потом не меняется — для другого счётчика заводится отдельное подключение. |
| Поля | Шаг «Выбор полей»: 134 поля. В новом подключении заранее отмечены 32 поля — 11 обязательных, которые не снимаются, и 21 рекомендованное. |
| Добавить конвертацию валют | Есть в визарде и сохраняется, но для Logs API не действует: выбранные валюты читает только коннектор отчётов Метрики, а в таблице визитов колонок с пересчётом не появляется. |
Технические поля
| Колонка | Что внутри |
|---|---|
Counter | Номер счётчика Метрики. Коннектор проставляет его в каждую строку. |
Служебных колонок rc_* у Logs API нет: rc_data_id, rc_created_at и rc_updated_at, которые встречаются у других коннекторов, здесь не создаются.
