API Яндекс Метрики даёт данные для своей базы отчётов, а агенты проверяют полноту выгрузки

Регулярную выгрузку заказывают от нужного отчёта. Если компании нужны визиты по дням и источникам, в базе достаточно хранить готовые сводные показатели.

API отчётов возвращает агрегаты, а Logs API даёт записи визитов или хитов. В быстром старте Яндекса, проверенном 8 октября 2026, это разные инструменты для разных задач.

Задача для агента называет результат. «Получать дневной отчёт и проверять полноту» задаёт приёмку. «Подключить Метрику» оставляет выбор агенту.

Одинаковые даты не гарантируют одинаковые числа. Загрузчик и контрольный отчёт должны использовать тот же счётчик, фильтр и часовой пояс.

Период и часовой пояс задают явно. По справочнику API отчётов пояс по умолчанию берётся у счётчика. Это значение фиксируют в задании.

Паспорт запроса сохраняют рядом с результатом. Он позволяет повторить выгрузку за конкретные даты и объяснить расхождение. Запись «загрузили вчера» этого не позволяет.

Полнота загрузки отличается от полноты выборки. Метрика считает часть визитов при семплировании. Все страницы такого отчёта не означают все исходные визиты.

Агент сохраняет sampled и sample_share. Если нужен расчёт по всем данным, ответ с выборкой не принимают молча. Точность согласуют заранее.

Logs API требует правила свежести. По документации Яндекса сведения о визитах дополняются. Недавние даты перечитывают по согласованному расписанию.

Первый ответ API отчётов по умолчанию содержит до 100 строк, по справочнику Яндекса. Следующую страницу запрашивают параметром offset.

Число строк сверяют с total_rows. При total_rows_rounded оно округлено и не доказывает полноту. Порядок строк фиксируют для всей выгрузки.

В учебном отчёте из 250 строк нужны три запроса с лимитом 100. Приёмка только первого пропустит 150 строк. Последняя страница содержит 50 строк.

Пустой ответ сначала проверяют на корректность. Он бывает результатом периода без данных или неверного фильтра. Ошибку доступа и оборванное тело ответа сохраняют как сбой.

Временный сбой повторяют с паузой, доступ проверяет инженер. Старый отчёт сохраняют с датой его данных. Новый период показывают как неполученный.

В Logs API ждут processed, скачивают все parts и сверяют запись в базе. Подготовленные логи очищают после подтверждённого сохранения.

Повтор не должен добавлять те же данные ещё раз. Для сводки заменяют проверенный срез за период. Для отдельных записей нужен ключ, который исключает дубли.

Новый срез проверяют до замены принятого отчёта. Если старый отчёт удалить перед первым запросом, сбой оставит бизнес без данных. Это запрещают в задании.

Это правило записывают в правила для агентов. Агенту поручают проверки повтора, обрыва и восстановления. Успешный запуск на коротком ответе не доказывает ни одну из них.

Равное число строк не доказывает правильность загрузки. Это могут быть строки за другой период. Поэтому сверяют также ключи и выбранные показатели.

Показатели считают по согласованному правилу. Посетители разных дней пересекаются, дневные проценты нельзя усреднить без весов. Простое сложение исказит отчёт.

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

Проверка отвечает, что дошло до отчёта. Без разбора структуры оборванный ответ можно принять за отсутствие данных. Успешный запуск этого не доказывает.

Наша машина ошибалась в разборе ответа и фильтре запроса. После ремонта остались проверки результата. Их происхождение видно в ленте ниже.

Инженер ведёт машину агентов на vibecoding.ru. Её работу показывает открытый счётчик машины. Истории относятся к нашему сайту.

Сторож видит последнюю принятую дату. «Скрипт запускался» не доказывает получение данных. Пустой отчёт, ошибку и устаревшие данные показывают раздельно.

Сигнал поступает инженеру с периодом и причиной сбоя. Загрузчик повторяет непринятый период и сверяет базу. Сигнал закрывается после принятой догрузки.

В уроке «Руль, окно и сторож» курса агентной разработки правило задаёт результат, экран показывает состояние, проверка замечает отклонение. Для выгрузки нужна та же связка.

CTO выбирает поля и целевую базу. Инженер ведёт агентов, которые пишут загрузчик и проверки в репозитории компании. Там же описывают запуск и приёмку.

В подписке на разработку «Один проект» стоит 250 000 ₽ в месяц, по странице услуг на 8 октября 2026. Одна задача в работе, следующая ждёт в очереди.

Фикс оплачивает месяц работы, пауза возможна в любой месяц. Лицензии сторонних сервисов, их комиссии и расходы на работу продукта считают отдельно.

Для разового экспорта достаточно отчёта Метрики. Подписка нужна, когда выгрузку поддерживают и задачи идут дальше. Ради единственного файла покупать месяц незачем.

Приёмку CTO можно повторить. Контрольный период, обрыв и догрузка без дублей показывают результат в базе. Обещание «скрипт работает» его не заменяет.

Чтобы обсудить свою выгрузку, достаточно назвать счётчик, нужный отчёт и целевую базу. Секретный токен в описание задачи не включают.