Отслеживание событий

Как передавать действия посетителя с виджета Контактиум в Яндекс.Метрику и Google Analytics и настраивать цели.

Содержание статьи

Зачем это нужно

Виджет может сообщать сайту, когда посетитель открыл чат, написал сообщение, оставил контакт или нажал кнопку связи. Эти действия можно отправлять в системы статистики и настраивать цели, например «написал в чат», «появился контакт» или «открыл чат сам».

О поддержке

Поддержка помогает с работой самого виджета, но не консультирует по JavaScript и настройке Яндекс.Метрики или Google Analytics.

Что нужно заранее

Список событий

Что произошлоКод событияДоп. данные
Виджет полностью загружен и готов к работеonLoadKontaktiumСобытие на странице: настройки получены, сессия создана, интерфейс доступен.
Клик по кнопке виджета или пункту «Чат» в меню контактовKontaktium:launcher-clickНет дополнительных данных.
Открыто окно чатаKontaktium:chat-openКто открыл: посетитель сам или автоматически триггером (detail.openBy).
Окно чата закрытоKontaktium:chat-closeНет дополнительных данных.
Посетитель отправил сообщениеKontaktium:chat-sendMessageНет дополнительных данных.
Создан контакт посетителяKontaktium:contact-createdВ чате появился телефон, email или мессенджер, создана карточка контакта (не путать с отправкой сообщения).
Посетитель получил сообщениеKontaktium:chat-incomingMessageОт кого: бот или менеджер (detail.from).
Показана подсказка с сообщением триггераKontaktium:trigger-showПоказана подсказка с текстом над кнопкой виджета (настройка «Сообщение триггера в подсказке»), чат ещё закрыт.
Клик по кнопке связиKontaktium:call-clickКакая кнопка: телефон, почта, Telegram, WhatsApp, Max или своя (kind custom, опционально customId).

Совет. Подсказка с сообщением триггера и открытие чата — разные события. Если настройка «Сообщение триггера в подсказке» выключена и чат открывается сразу, сработает только Kontaktium:chat-open (открыл триггер).

Куда вставить код

Отдельным блоком на сайт — после кода виджета или рядом со счётчиками. Скопируйте один из примеров ниже, подставьте свой номер счётчика и идентификатор цели, вставьте код на сайт.

Пример для Яндекс.Метрики

Цель срабатывает, когда посетитель отправил сообщение в чат.

<script>
document.addEventListener('onLoadKontaktium', () => {
  Kontaktium('Kontaktium:chat-sendMessage', function () {
    ym(НОМЕР_СЧЁТЧИКА, 'reachGoal', 'ИДЕНТИФИКАТОР_ЦЕЛИ');
  });
});
</script>
  • НОМЕР_СЧЁТЧИКА — номер счётчика Яндекс.Метрики.
  • ИДЕНТИФИКАТОР_ЦЕЛИ — идентификатор цели из Метрики (например Message-Kontaktium).
  • Вместо Kontaktium:chat-sendMessage можно подставить другой код события из таблицы выше.

Пример для Google Analytics

Через gtag.

<script>
document.addEventListener('onLoadKontaktium', () => {
  Kontaktium('Kontaktium:chat-sendMessage', function () {
    gtag('event', 'ИДЕНТИФИКАТОР_СОБЫТИЯ');
  });
});
</script>
  • ИДЕНТИФИКАТОР_СОБЫТИЯ — имя события в Google Analytics (например MessageKontaktium).
  • На сайте уже должен быть код Google Analytics с функцией gtag.

Разные цели для открытия чата

Разделяем «посетитель сам» и «триггер».

<script>
document.addEventListener('onLoadKontaktium', () => {
  Kontaktium('Kontaktium:chat-open', function (detail) {
    if (detail.openBy === 'user') {
      ym(НОМЕР_СЧЁТЧИКА, 'reachGoal', 'ChatOpen-User');
    } else {
      ym(НОМЕР_СЧЁТЧИКА, 'reachGoal', 'ChatOpen-Trigger');
    }
  });
});
</script>
  • «Посетитель сам» — открыл кнопку виджета, пункт «Чат» в меню контактов или кликнул по подсказке триггера.
  • «Триггер» — чат открылся сам (когда «Сообщение триггера в подсказке» выключено).

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

  1. 1Откройте сайт с виджетом в новой вкладке.
  2. 2Выполните нужное действие (например отправьте тестовое сообщение в чат).
  3. 3В Яндекс.Метрике или Google Analytics убедитесь, что цель или событие сработали (отладка, отчёт в реальном времени или проверка целей).
  4. 4Если ничего не видно — проверьте, что код стоит после загрузки виджета, счётчик подключён, а идентификаторы цели совпадают с кабинетом статистики.

Читайте также

Все статьи