Данные GA4 и Яндекс Метрики

Читайте просмотры страниц и трафик из GA4 и Яндекс Метрики, затем сопоставьте их с находками сканирования и исправьте страницы, которые на самом деле посещают. Оба подключения работают только на чтение.

Что делает

Яндекс Метрика

metrika-counters находит ID счётчика. metrika-setup показывает его цели, фильтры и операции с данными — их стоит прочитать до выводов. Затем metrika-report запрашивает нужные метрики и измерения с автоматической пагинацией.

  • Доступ — OAuth-токен Яндекса в YANDEX_METRIKA_TOKEN или в файле с токеном.
  • metrika-traffic-pdf собирает отчёт о трафике формата A4 в HTML и PDF. Для PDF нужен локальный Chrome, Edge или Chromium.
  • Сырые логи намеренно исключены, потому что в них есть идентификаторы посетителей.

Google Analytics 4

Отдельной команды CLI для GA4 нет. Данные собираются через provider-collect: операция page_views — для посещённых страниц, landing_pages — для посадочных. page_views считает screenPageViews по дате, хосту и пути для указанного вами ресурса.

  • Доступ — токен доступа GA4 (GA4_ACCESS_TOKEN) или сервисный аккаунт Google с областью analytics.readonly.
  • У аккаунта должен быть доступ на чтение к ресурсу.
  • Сырые строки попадают в закрытую локальную папку артефактов, а не в ответ инструмента.

Соединение с сканированием

crawl-enrich сопоставляет CSV с трафиком, где ключ — URL, с URL из скана и добавляет находки аналитики по колонкам визитов и отказов, которые вы укажете. Если есть проект, sources-sync хранит ежедневную историю в локальном файле SQLite, а sf run сопоставляет её со страницами аудита офлайн.

  • Из сопоставления появляются находки: страницы-сироты, страницы без данных и неиндексируемые страницы с трафиком.
  • Совпавшие URL, URL только из скана и URL только из внешних данных остаются отдельными группами.
  • Цифры GA4 и Метрики никогда не суммируются.

Три шага — один сохранённый скан

  1. Сначала проверьте настройку счётчика

    Запустите metrika-counters, чтобы найти ID счётчика, затем metrika-setup — чтобы увидеть цели, фильтры и операции с данными.

  2. Загрузите визиты и просмотры страниц

    metrika-report читает Яндекс Метрику с любыми метриками и измерениями. Просмотры страниц GA4 берутся через provider-collect, операция ga4 page_views.

  3. Сопоставьте цифры со сканированием

    crawl-enrich сопоставляет CSV с трафиком и URL скана по адресу страницы и добавляет находки аналитики, включая колонки визитов и показателя отказов.

Проверки в этой возможности

ПроверкаЧто значитКритичностьДоказательство
GA_ORPHAN_URLВ данных аналитики есть URL того же домена, которого не нашло сканированиеImportantСписок URL из сопоставления. При частичном сканировании не выводится
NON_INDEXABLE_WITH_GA_DATAНеиндексируемая страница всё ещё получает визиты выше нуляImportantURL и число визитов из --visits-column
NO_GA_DATAУ индексируемой страницы из скана нет строки аналитикиTipСписок URL. Перед тем как действовать, проверьте измеренный период и разметку аналитики
BOUNCE_RATE_ABOVE_70Показатель отказов страницы выше 70%TipURL и показатель отказов из --bounce-column

Одна команда

bash
seohead metrika-report --counter 12345678 --date1 2026-09-01 --date2 2026-09-30

Сначала установите: руководство по установке. Каждая команда работает и как MCP-инструмент для ИИ-агентов.

Что нужно

  • Яндекс Метрика: ID счётчика и OAuth-токен
  • GA4: ID ресурса и токен доступа или сервисный аккаунт с analytics.readonly
  • Диапазон дат
  • Сканирование или аудит, а также CSV с трафиком, если вы используете crawl-enrich

Ограничения

  • Просмотры страниц в GA4 — это не сеансы, не пользователи и не сеансы на посадочных страницах, и они не доказывают, что изменение повлияло на трафик.
  • Сбор из GA4 возвращает не больше 100 000 строк за запуск. Данные с порогами и сэмплированные данные помечаются.
  • Нулевые визиты могут появиться из-за разметки или фильтров, поэтому сначала проверьте metrika-setup.
  • Пропущенные строки — не измеренные нули. Отрицательная находка требует полного сканирования и полного покрытия данными провайдера.

Вопросы

Меняет ли это мой сайт или настройки аналитики?
Нет. Каждый вызов только читает данные. metrika-setup лишь показывает, как настроен счётчик. Сохранённые данные остаются в локальной папке.
Какой доступ нужен?
Для Метрики — OAuth-токен Яндекса в настройке YANDEX_METRIKA_TOKEN или в его файле. Для GA4 — GA4_ACCESS_TOKEN или сервисный аккаунт с областью analytics.readonly и доступом на чтение к ресурсу.
Почему страница с нулевыми визитами не всегда означает проблему?
Ноль может появиться из-за настройки. Если цели или фильтры не заданы, цифры могут быть неполными. Прежде чем делать выводы по трафику, проверьте metrika-setup.
Читает ли он сырые логи посетителей?
Нет. Сырые логи Метрики исключены по замыслу, потому что содержат идентификаторы посетителей. Инструмент использует только агрегированные отчёты.
Сколько это стоит?
SpiderHead не берёт плату за эти команды. Вызовы расходуют квоты API Метрики и GA4 на вашем аккаунте.
Что хранится на моём компьютере?
Сырые строки GA4 попадают в закрытую папку артефактов, которую вы выбираете. sources-sync пишет ежедневную историю в файл SQLite проекта и не сохраняет токены. metrika-report выводит результат; если он нужен, сохраните его сами.

Проверьте на своём сайте