Платформа
Яндекс Метрика
Счётчики, отчёты, цели и безопасная работа агента с веб-аналитикой.
Яндекс Метрика
Приложение Яндекс Метрика подключает счётчики рабочего пространства к агенту. Агент собирает отчёты, сравнивает периоды, анализирует источники трафика и конверсии, а с правом записи помогает управлять целями.
Назначение
Метрика нужна, когда вы хотите получать ответы по данным сайта прямо в Promto:
- визиты, посетители, просмотры, отказы и глубина просмотра;
- источники трафика, страницы, устройства и сегменты;
- цели и конверсии;
- сравнение периодов и поиск причин роста или просадки;
- создание и изменение целей после подтверждения.
Подключение
Подключить и отключить Метрику может только владелец рабочего пространства.
Основной способ:
- Откройте Яндекс Метрика → Настройки.
- Нажмите Получить код подтверждения.
- Откройте предложенную страницу Яндекса.
- Войдите под аккаунтом, которому доступны нужные счётчики.
- Введите короткий код и разрешите доступ.
- Дождитесь автоматического завершения подключения.
Токен передаётся напрямую на сервер Promto и не появляется в браузере или рабочем окружении агента.
Если используется собственное приложение Яндекс OAuth, выберите ручное подключение. Создайте приложение для доступа к API, включите metrika:read, а для работы с целями — metrika:write. Затем укажите ClientID, получите OAuth-токен по собранной ссылке и вставьте его в Promto. Client secret вводить не нужно.
Интерфейс
На странице Главная доступны готовые сценарии: недельный отчёт, источники трафика, конверсии, настройка цели, сравнение периодов и поиск причины просадки.
В Настройках показываются:
- состояние подключения;
- маска OAuth-токена;
- список доступных счётчиков, их названия, сайты и числовые ID;
- ошибка токена, если Яндекс отозвал доступ;
- кнопка отключения.
Обновление окна перечитывает актуальный список счётчиков.
Возможности агента
Основной агент использует promto_metrika.
| Задача | Действия |
|---|---|
| Счётчики | list_counters, get_counter |
| Цели | list_goals, create_goal, update_goal, delete_goal |
| Отчёты | stats |
| Дополнительные методы API | request |
Сначала агент получает ID счётчика через list_counters. Для отчётов он передаёт метрики и измерения Метрики, например ym:s:visits, ym:s:users, ym:pv:pageviews, ym:s:date и ym:s:trafficSource.
Сценарии
Еженедельный отчёт
Попросите сравнить последние семь дней с предыдущей неделей: визиты, посетителей, просмотры, отказы, источники и главные страницы. Агент вернёт таблицу и выделит подтверждённые изменения.
Найти причину падения трафика
Укажите примерную дату просадки. Агент сравнит источники, страницы и устройства до и после неё и сформулирует гипотезы на основе данных.
Настроить цель
Опишите действие пользователя: посещение страницы, клик или событие. Агент покажет имя, тип и условия цели и создаст её только после вашего подтверждения.
Ограничения и безопасность
- Агент видит только счётчики, доступные подключённому аккаунту.
- Для чтения достаточно
metrika:read; безmetrika:writeизменить цели нельзя. - Обновление и удаление цели меняет живой счётчик. Перед операцией проверьте ID, условия и ожидаемый результат.
- Ответ больше 512 КБ сокращается. Уменьшите период, добавьте фильтр или снизьте лимит.
- Даты задаются как
YYYY-MM-DDили поддерживаемыми словами вродеtoday,yesterday,7daysAgo. - При ограничении частоты запросов агент должен дождаться указанного времени, а не повторять запрос сразу.
- Токен хранится только на сервере; действия через подключение журналируются.
Если что-то не работает
Код подтверждения истёк. Получите новый код и повторите вход на странице Яндекса.
Нет нужного счётчика. Проверьте, что вошли тем аккаунтом, которому выдан доступ к счётчику, затем обновите окно.
Не удаётся создать цель. Проверьте наличие права metrika:write. При ручном подключении может потребоваться новый токен с расширенным набором прав.
Яндекс отклоняет токен. Отключите аккаунт и подключите его заново. Не отправляйте токен агенту или в чат поддержки.
Отчёт слишком большой или неполный. Сузьте диапазон дат, выберите конкретный счётчик и ограничьте метрики, измерения или число строк.