Документация/Каналы

Цели в Яндекс Метрике

Обновлено 7 ноября 2026 г.

Виджет на сайте умеет сам отправлять цели в Яндекс Метрику, которая уже стоит на вашем сайте. Так в Метрике видно, с какой рекламы и из каких источников приходят те, кто открывает чат, пишет в него и оставляет заявку. Цели можно использовать в отчётах Метрики и для оптимизации рекламы в Директе.

Код на сайте менять не нужно: цели отправляет сам виджет через счётчик Метрики, установленный на странице. Работает только для «Виджета на сайте» — у виджета поддержки целей нет.

Какие события отправляются

  • Открыл чат (идентификатор по умолчанию — envybox_chat_open). Посетитель открыл окно чата любым способом: нашей кнопкой, автоприглашением, зацепкой или своей кнопкой сайта. Отправляется один раз за визит.
  • Первое сообщение (envybox_first_message). Посетитель отправил в чат первое сообщение — текст или фото. Один раз за диалог.
  • Агент принял заявку (envybox_lead). Агент передал данные навыком, у которого включено «Отметить цель достигнутой». Один раз за диалог, подробнее — ниже.

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

Как включить в кабинете

  1. Откройте канал «Виджет на сайте» и перейдите на вкладку «Установка на сайт».
  2. В блоке «Дополнительно» раскройте «Цели в Яндекс Метрике» и включите «Отправлять цели».
  3. В поле «Номер счётчика» впишите номер своего счётчика — он есть в Метрике рядом с названием счётчика. Если оставить поле пустым, цели уйдут во все счётчики Метрики, которые найдутся на странице.
  4. В списке «События» оставьте включёнными нужные. Идентификатор каждой цели можно поменять — латиница, цифры, «_», «-» или «.». Если меняете, запомните новое значение: в Метрике нужно указать точно такое же.
  5. Нажмите «Сохранить».

Как создать цель в Метрике

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

  1. Откройте счётчик в Яндекс Метрике и перейдите в раздел «Цели».
  2. Нажмите «Добавить цель».
  3. Выберите тип «JavaScript-событие».
  4. В поле идентификатора вставьте идентификатор из кабинета, например envybox_chat_open. Он должен совпадать полностью, вплоть до регистра букв.
  5. Дайте цели понятное название — например «Чат: открыл окно» — и сохраните.

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

Цель «Агент принял заявку»

Эта цель срабатывает не на любой ответ агента, а только когда он вызвал навык, у которого включено «Отметить цель достигнутой» — обычно это навык передачи заявки в CRM, Telegram или на почту. Если ни один навык агента так не отмечен, кабинет предупредит прямо у этой строки и предложит «Открыть навыки».

  • Если вы сами отметили цель в «Диалогах» или вызвали навык вручную, в Метрику цель не отправляется — она только про заявки, которые принял агент.
  • Метрика считает события в браузере посетителя, поэтому цель уходит, пока он на вашем сайте. Перешёл на другую страницу сайта — цель всё равно дойдёт, если заявка была принята не больше суток назад. Закрыл сайт и не возвращался — цель не отправится.

Как проверить

  1. Откройте свой сайт в новой вкладке, лучше в режиме инкогнито — так виджет посчитает вас новым посетителем.
  2. Откройте чат, напишите сообщение, при желании доведите разговор до заявки.
  3. В Метрике откройте отчёт «Конверсии» — достижения появятся там в течение нескольких минут. Быстрее увидеть их можно в режиме отладки: добавьте к адресу страницы ?_ym_debug=1 и откройте консоль браузера — Метрика печатает туда каждую отправленную цель.

Совет. Тестовая страница виджета на нашем домене (вкладка «Тестирование») для проверки целей не подходит: на ней нет вашего счётчика Метрики. Проверяйте на своём сайте.

Если цели не приходят

  • Цель не создана в Метрике или идентификатор отличается. Сверьте идентификатор в кабинете и в Метрике символ в символ.
  • Не нажали «Сохранить». Изменения в редакторе виджета начинают действовать только после сохранения.
  • Указан чужой номер счётчика. Проверьте номер или оставьте поле пустым — тогда цели уйдут во все счётчики на странице.
  • Метрика не загрузилась. Виджет ждёт счётчик около десяти секунд после события, потом перестаёт пытаться. Если Метрика на сайте подключается с большой задержкой или её блокирует расширение браузера посетителя, отдельные достижения могут не дойти.
  • Вы уже проверяли в этой вкладке. «Открыл чат» отправляется раз за визит, остальные цели — раз за диалог. Для повторной проверки откройте сайт в новой вкладке инкогнито.

Цели в своём коде сайта

Те же три события виджет сообщает и коду вашего сайта — например, чтобы передать их в другую систему аналитики. Это работает всегда, даже если отправка в Метрику выключена, и настраивать в кабинете ничего не нужно. Задача для программиста сайта: подписаться через EnvyboxAgentWidget.on("goal", функция) или на событие страницы envyboxagent:goal (данные — в поле detail).

В событии приходят: event — какое событие (chatOpen, firstMessage или lead), channelId — виджет, conversationId — диалог (у «Открыл чат» его может не быть, если посетитель ещё не писал), goalId — идентификатор цели Метрики, если отправка в Метрику настроена, pageUrl — адрес страницы, а у заявки ещё callId — номер конкретной заявки.

  • Имя, телефон и другие данные посетителя в событие не попадают — на него может подписаться любой скрипт на странице.
  • «Агент принял заявку» приходит на каждую заявку: если в одном диалоге их было две, придут два события. В Метрику — по-прежнему одна цель за диалог.
  • conversationId — служебный номер для связи с диалогом. Не публикуйте его в открытом виде.