Документация для клиента: счётчик полевых метрик (field/RUM)

Кому: владелец сайта-потребителя, веб-мастер, SEO-специалист. Зачем: подключить сбор полевых метрик, читать метрики, диагностировать проблемы.

1. Документы раздела

Документ	О чём
`install-rum-js.md`	Как подключить счётчик: готовый код встраивания, требования к CSP, SPA, приватность, проверка установки
`metrics.md`	Справочник метрик: что измеряется, единицы, пороги «хорошо/плохо», ограничения
`troubleshooting.md`	Диагностика: почему данных нет и что делать пошагово
`faq.md`	Короткие ответы на частые вопросы

2. Что такое счётчик полевых метрик

«Полевые» (field/RUM) метрики — это показатели реальных посетителей вашего сайта: Core Web Vitals (LCP, INP, CLS) и расширенный набор (разложение TTFB, long tasks, ресурсы, ошибки, просмотры и сессии).

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

Полевые метрики — это данные реальных пользователей. Они не заменяют лабораторные (Lighthouse, WebPageTest): источники не смешиваются.

3. Быстрый старт

Возьмите токен проекта (в личном кабинете проекта).
Убедитесь, что приём событий включён для проекта (настройки проекта в личном кабинете).
Встройте готовый код на сайт — см. install-rum-js.md §3.
Проверьте, что данные идут — install-rum-js.md §8.
Если данных нет — troubleshooting.md.

4. Что намеренно отсутствует в публичном разделе

Управление токенами и настройками приёма (сроки хранения, лимиты, тарифы) — это данные вашего аккаунта. Они доступны после входа в личный кабинет и описаны в соответствующем закрытом разделе личного кабинета.