---
metadata:
- name: generator
content: Diplodoc Platform v5.50.6
alternate:
- https://yandex.com.tr/support/metrica/en/data/chat.md
- https://yandex.com.tr/support/metrica/es/data/chat.md
- https://yandex.com.tr/support/metrica/pt/data/chat.md
- https://yandex.com.tr/support/metrica/ru/data/chat.md
- https://yandex.com.tr/support/metrica/tr/data/chat.md
title: Импорт чатов
description: Если пользователи при взаимодействии с сайтом предпочитают уточнять информацию или оформлять заказы в мессенджерах (WhatsApp, Telegram или Viber), вы можете отслеживать такие обращения в чаты и связывать их с действиями посетителей на сайте.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/metrica/ru/llms.txt
# Импорт чатов
Если пользователи при взаимодействии с сайтом предпочитают уточнять информацию или оформлять заказы в мессенджерах (WhatsApp, Telegram или Viber), вы можете отслеживать такие обращения в чаты и связывать их с действиями посетителей на сайте.
Импорт чатов помогает:
- узнать, сколько было чат-конверсий;
- оценить их качество — например, сколько чатов осталось без ответа;
- оценить результат — например, привела ли переписка к покупке;
- получить более полную картину взаимодействия с клиентами и эффективности рекламных каналов, которые приводят к диалогам в мессенджерах.
## Как отслеживать чаты в Метрике {#follow}
Чтобы собирать данные, используйте [сервисы трекинга чатов](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) или собственное решение и передавайте данные о чатах в Метрику с помощью [API](https://yandex.com.tr/dev/metrika/ru/data-import/).
{% note info %}
Если вы используете собственное решение и передачу через API, на сайте должна быть настроена система сбора идентификаторов посетителей (`ClientID`, `UserID`, `Yclid`, `EPurchaseID`), чтобы связать офлайн-чат с конкретным визитом на сайте.
{% endnote %}
В Яндекс Метрике чаты учитываются с помощью [целей](https://yandex.com.tr/support/metrica/ru/general/goals.md) — при первой загрузке данных о чат-конверсии автоматически создается специальная цель с типом **Чат**. Эта автоцель появится в интерфейсе Метрики на странице управления целями.
{.border-yes}
Заводить отдельную цель вручную не нужно — Метрика распознает загруженные события чатов и начнет считать их достижения.
Цель **Чат** можно добавлять во все отчеты Метрики. Для этой цели будут доступны целевые метрики (конверсии, достигнутые цели и т.д.) Также цель и полученные конверсии можно использовать при оптимизации рекламы, редактировать на срабатывание только для определенных чатов и добавлять новые цели этого типа.
## Какую информацию о чатах можно передавать {#info}
{% note warning %}
Загруженные данные о чатах появятся в отчетах Метрики в течение 2 часов после успешной загрузки.
{% endnote %}
С помощью API или [сервисов трекинга мессенджеров](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) можно передавать в Метрику основную и дополнительную информацию о чатах. Обязательными являются данные для идентификации события чата во времени и по мессенджеру, а также идентификаторы самого диалога. Дополнительно можно отправлять показатели качества и ценности чата.
Ниже указаны возможные данные и их использование в отчетах.
**Поля для загрузки чатов**
#|
|| **Информация** | **Обязательность** | **Описание** ||
|| Дата и время чата (Unix-время, UTC) | Да | Используется для фиксации события чата. Обязательно указывать в Unix timestamp (UTC) ||
|| Платформа чата (messenger: `whatsapp`, `telegram`, `viber`) | Да | Название мессенджера, должно быть одним из поддерживаемых: `whatsapp`, `telegram` или `viber` ||
|| Идентификаторы чата (никнейм, ID, телефон) | Да (хотя бы один) | Хотя бы одно из полей: `ChatUsername`, `ChatUserID` или `PhoneNumber` должно быть заполнено ||
|| Ответ на чат (получил ли пользователь ответ) | Нет | Фиксирует, был ли ответ от оператора. Значение: `1` или `0` ||
|| Метки (теги) чата | Нет | Текстовая метка до 100 символов для сегментации чатов ||
|| Сумма по конверсии (ценность чата) и валюта | Нет | Позволяет передать доход по чату: числовое значение и код валюты (ISO 4217) ||
|| URL страницы сайта, с которой начат чат | Нет | Адрес страницы, откуда пользователь начал диалог ||
|| Ссылка сервиса мессенджер-трекинга | Нет | Техническая ссылка на чат в системе трекинга для внутреннего анализа ||
|#
## Как передавать данные о чатах {#how-send}
Интеграцию можно выполнить двумя способами:
- **Через [сервисы чат-трекинга](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
Поставщик предоставляет код — виджет или скрипт — который необходимо разместить на сайте. Код автоматически собирает требуемые идентификаторы и готовит события к импорту в Метрику.
- **Через API напрямую**
В этом случае следуйте рекомендациям ниже.
### Шаг 1 — Сбор идентификаторов посетителя {#step-1}
**Цель**: обеспечить привязку чата к визиту на сайте или к рекламному клику.
- **При использовании [сервиса чат-трекинга](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866)**
Достаточно установить предоставленный код. Он самостоятельно считает и передаст нужные идентификаторы Метрики:
- **ClientID** из `_ym_uid;`
- **UserID** при необходимости;
- **Yclid** для трафика из Директа.
- **При собственной интеграции**
Передавайте один или несколько идентификаторов:
- **ClientID** — основной идентификатор посетителя Метрики. Рекомендуем передавать, когда чат начался после визита на сайт.
- **UserID** — ваш внутренний идентификатор пользователя, если функция UserID включена.
- **Yclid** — идентификатор клика Директа. Актуален, когда основной трафик идет из Директа.
- **PurchaseID** — идентификатор заказа, если чат относится к конкретной транзакции. Редкий сценарий.
Если ни один идентификатор не передан, событие будет загружено как **неатрибутированное**, без привязки к визиту или клику.
### Шаг 2 — Включайте собственный идентификатор чата в ссылки на мессенджеры {#step-2}
**Цель**: при старте диалога однозначно сопоставить чат с идентификаторами Метрики из шага 1.
Рекомендуемая схема, которую применяют [сервисы чат-трекинга](https://metrika.yandex.ru/r/marketplace?filter=68ffa9395e9a080015db1866) — можно использовать при собственной интеграции:
1. Сгенерируйте **уникальный идентификатор чата**. Например `CT8F2A9`.
2. Код на сайте **добавит этот идентификатор в каждую ссылку на мессенджер**:
- **Telegram-бот** — через deeplink (параметр запуска). Пользователь не увидит идентификатор, но бот получит его при первом обращении.
- **Личные аккаунты Telegram, WhatsApp или Viber** — через заранее подготовленный **шаблон первого сообщения**, в который подставляется идентификатор. Например техническая метка в конце сообщения.
3. После начала диалога сервис извлечет идентификатор чата из deeplink или из первого сообщения и **сопоставит** его с собранными ранее идентификаторами Метрики: `ClientID`, `UserID`, `Yclid`.
4. Появится устойчивая связка **chat-ID ↔ идентификаторы Метрики**, достаточная для корректной атрибуции.
### Шаг 3 — Импорт событий в Метрику {#step-3}
Когда связка сформирована, передавайте события чатов через [API импорта чатов Метрики](https://yandex.com.tr/dev/metrika/ru/management/chats). Требования к формату данных (время события, допустимые значения платформы, структура полей и т. д.) описаны в спецификации API.
[Написать в чат](https://yandex.com.tr/chat/#/user/036e6a02-3620-9cdc-4c5e-a34667a7379e?utm_source=spravka){.button}
- - -
#|
||
Полезные ссылки
- [Демосчетчик](https://metrica.yandex.com.tr/r/dashboard?)
- [Добавить счетчик](https://metrica.yandex.com.tr/add/)
- [Бесплатная настройка счетчика](https://yandex.com.tr/promo/freeservice/metrica?utm_source=help_metrica_tr&utm_medium=cpc&utm_campaign=1)
- [API Яндекс Метрики](https://tech.yandex.com.tr/metrika/)
- [Предложить идею](https://yandex.com.tr/support/metrica/troubleshooting/idea.html)
- [Обсудить в Telegram](https://t.me/yandexmetrika)
|
Онлайн-обучение
- [Получить сертификат по Яндекс Метрике](https://yandex.ru/adv/expert/exam/metrika/?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
- [Пройти обучающий курс](https://yandex.com/adv/edu/online/metrika?utm_source=metrika_help&utm_medium=web&utm_campaign=static&utm_content=useful_links)
||
|#