·10 мин·Практикум Yaga

Метрика из CLI: status, counter и YTM

После Вебмастера логичный второй public-brick — metrika. Три подкоманды, несколько ключей в credentials и типичная путаница между общим OAuth и отдельным токеном Метрики.

MetrikaYTManalytics

В bricks.go brick metrika (алиасы metrica, ym) принимает status | counter | ytm. Default — status. Скрипты: yandex-metrika-status.mjs, yandex-metrika-counter.mjs, yandex-ytm-status.mjs.

Какие credentials смотреть

Из allCredSpecs() для Метрики фигурируют:

  • YANDEX_OAUTH_TOKEN — общий access token (в how-to указан путь через webmaster oauth / oauth.yandex.ru).
  • YANDEX_METRIKA_OAUTH_TOKEN — опциональный отдельный токен с правами Метрики.
  • NEXT_PUBLIC_YANDEX_METRIKA_ID — числовой ID счётчика (как в кабинете / URL списка счётчиков).
yaga credentials
yaga doctor

Если doctor ругается на отсутствие token — не начинайте с counter: сначала OAuth и права приложения.

status

yaga metrika status
yaga ym status

Базовый снимок: жив ли доступ и что отдаёт API для текущего контекста. Это аналог «открыть кабинет и глазами проверить», только из терминала — удобно в CI-привычках и перед релизом тегов.

counter

yaga metrika counter

Работа со счётчиком через yandex-metrika-counter.mjs. Имеет смысл, когда нужно убедиться, что ID и настройки совпадают с тем, что зашито в сайт (NEXT_PUBLIC_YANDEX_METRIKA_ID).

ytm

yaga metrika ytm
# алиас подкоманды: tag

Статус Yandex Tag Manager / теговой обвязки через yandex-ytm-status.mjs. Полезно после правок контейнера: CLI не заменяет UI YTM, но быстро показывает, отвалился ли доступ.

Связка с Вебмастером

yaga webmaster status уже включает метрический срез в общем снимке. Brick metrika нужен, когда копаете аналитику отдельно: счётчик, YTM, права токена. Не смешивайте в голове ClientID Вебмастера и ID счётчика Метрики — это разные сущности.

Типичные ошибки

  • Токен без scope Метрики → 403, хотя Вебмастер работает.
  • В env сайта один ID, в credentials — другой.
  • Ожидание, что status «починит» дубли счётчиков на странице — нет, это read/ops helper.

Итог

Минимальный контур практикума по Метрике: credentials/doctor → metrika status → при необходимости counter/ytm. Вместе с webmaster seo это закрывает «поиск + аналитика» без открытия десяти вкладок кабинета.

Шпаргалка команд

bash · yaga
yaga credentialsyaga doctoryaga metrika statusyaga metrika counteryaga metrika ytmyaga ym status
Не официальная программа Яндекса — внутренний практикум Bober AI Systems по фактам из cli/yaga.