Импорт чатов

Если пользователи при взаимодействии с сайтом предпочитают уточнять информацию или оформлять заказы в мессенджерах (WhatsApp, Telegram или Viber), вы можете отслеживать такие обращения в чаты и связывать их с действиями посетителей на сайте.

Импорт чатов помогает:

• узнать, сколько было чат-конверсий;
• оценить их качество — например, сколько чатов осталось без ответа;
• оценить результат — например, привела ли переписка к покупке;
• получить более полную картину взаимодействия с клиентами и эффективности рекламных каналов, которые приводят к диалогам в мессенджерах.

Как отслеживать чаты в Метрике

Чтобы собирать данные, используйте сервисы трекинга чатов или собственное решение и передавайте данные о чатах в Метрику с помощью API.

В Яндекс Метрике чаты учитываются с помощью целей — при первой загрузке данных о чат-конверсии автоматически создается специальная цель с типом Чат. Эта автоцель появится в интерфейсе Метрики на странице управления целями.

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

Цель Чат можно добавлять во все отчеты Метрики. Для этой цели будут доступны целевые метрики (конверсии, достигнутые цели и т.д.) Также цель и полученные конверсии можно использовать при оптимизации рекламы, редактировать на срабатывание только для определенных чатов и добавлять новые цели этого типа.

Какую информацию о чатах можно передавать

С помощью API или сервисов трекинга мессенджеров можно передавать в Метрику основную и дополнительную информацию о чатах. Обязательными являются данные для идентификации события чата во времени и по мессенджеру, а также идентификаторы самого диалога. Дополнительно можно отправлять показатели качества и ценности чата.

Ниже указаны возможные данные и их использование в отчетах.

Поля для загрузки чатов

Информация	Обязательность	Описание
Дата и время чата (Unix-время, UTC)	Да	Используется для фиксации события чата. Обязательно указывать в Unix timestamp (UTC)
Платформа чата (messenger: whatsapp, telegram, viber)	Да	Название мессенджера, должно быть одним из поддерживаемых: whatsapp, telegram или viber
Идентификаторы чата (никнейм, ID, телефон)	Да (хотя бы один)	Хотя бы одно из полей: ChatUsername, ChatUserID или PhoneNumber должно быть заполнено
Ответ на чат (получил ли пользователь ответ)	Нет	Фиксирует, был ли ответ от оператора. Значение: 1 или 0
Метки (теги) чата	Нет	Текстовая метка до 100 символов для сегментации чатов
Сумма по конверсии (ценность чата) и валюта	Нет	Позволяет передать доход по чату: числовое значение и код валюты (ISO 4217)
URL страницы сайта, с которой начат чат	Нет	Адрес страницы, откуда пользователь начал диалог
Ссылка сервиса мессенджер-трекинга	Нет	Техническая ссылка на чат в системе трекинга для внутреннего анализа

Как передавать данные о чатах

Интеграцию можно выполнить двумя способами:

• Через сервисы чат-трекинга

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

• Через API напрямую

  В этом случае следуйте рекомендациям ниже.

Шаг 1 — Сбор идентификаторов посетителя

Цель: обеспечить привязку чата к визиту на сайте или к рекламному клику.

• При использовании сервиса чат-трекинга

  Достаточно установить предоставленный код. Он самостоятельно считает и передаст нужные идентификаторы Метрики:

  • ClientID из _ym_uid;
  • UserID при необходимости;
  • Yclid для трафика из Директа.

• При собственной интеграции

  Передавайте один или несколько идентификаторов:

  • ClientID — основной идентификатор посетителя Метрики. Рекомендуем передавать, когда чат начался после визита на сайт.
  • UserID — ваш внутренний идентификатор пользователя, если функция UserID включена.
  • Yclid — идентификатор клика Директа. Актуален, когда пользователь переходит сразу в мессенджер, минуя сайт.
  • PurchaseID — идентификатор заказа, если чат относится к конкретной транзакции. Редкий сценарий.

Если ни один идентификатор не передан, событие будет загружено как неатрибутированное, без привязки к визиту или клику.

Шаг 2 — Включайте собственный идентификатор чата в ссылки на мессенджеры

Цель: при старте диалога однозначно сопоставить чат с идентификаторами Метрики из шага 1.

Рекомендуемая схема, которую применяют сервисы чат-трекинга — можно использовать при собственной интеграции:

1. Сгенерируйте уникальный идентификатор чата. Например CT8F2A9.

2. Код на сайте добавит этот идентификатор в каждую ссылку на мессенджер:

   • Telegram-бот — через deeplink (параметр запуска). Пользователь не увидит идентификатор, но бот получит его при первом обращении.
   • Личные аккаунты Telegram, WhatsApp или Viber — через заранее подготовленный шаблон первого сообщения, в который подставляется идентификатор. Например техническая метка в конце сообщения.

3. После начала диалога сервис извлечет идентификатор чата из deeplink или из первого сообщения и сопоставит его с собранными ранее идентификаторами Метрики: ClientID, UserID, Yclid.

4. Появится устойчивая связка chat-ID ↔ идентификаторы Метрики, достаточная для корректной атрибуции.

Шаг 3 — Импорт событий в Метрику

Когда связка сформирована, передавайте события чатов через API импорта чатов Метрики. Требования к формату данных (время события, допустимые значения платформы, структура полей и т. д.) описаны в спецификации API.

Написать в чат

---