# Яндекс Метрика

## Интеграция Radist.Online с Яндекс Метрикой

В рамках партнёрской интеграции с **Яндекс Метрикой** реализована поддержка нового API, который позволяет учитывать **чаты как офлайн-конверсии**.\
Теперь можно передавать события чатов в Метрику, связывать их с визитами пользователей на сайте и использовать эти данные в **оптимизации рекламных кампаний Яндекс.Директ**.

***

### 💬 Поддерживаемые мессенджеры

Интеграция поддерживает передачу данных из следующих каналов:

* **Telegram**
* **Telegram Bot**
* **WhatsApp Business**
* **WABA**

> ⚠️ Мессенджер **MAX** не поддерживается.

***

### 📤 Данные, передаваемые в Яндекс Метрику

При переходе пользователя из чата в Метрику передаются следующие параметры:

| Поле                      | Описание                                                          |
| ------------------------- | ----------------------------------------------------------------- |
| **ym\_uid**, **yclid**    | Идентификаторы клиента и клика по рекламе                         |
| **chat\_id**              | Уникальный идентификатор чата                                     |
| **Номер телефона**        | Передаётся, если указан                                           |
| **Username**              | Передаётся, если есть                                             |
| **URL страницы**          | Страница, с которой пользователь перешёл в чат                    |
| **Платформа**             | WhatsApp или Telegram                                             |
| **Признак “чат отвечен”** | Добавляется, когда оператор отвечает клиенту (из CRM, API или ЛК) |

***

### 📊 Как отображаются данные в Метрике

* Все чаты передаются в Метрику как **офлайн-конверсии**.
* Автоматически создаётся **автоцель “Chat”**.
* События можно использовать в **отчётах** и **оптимизации рекламных кампаний**.

\
Примеры (см. скриншоты):<br>

* Передача данных в Метрику:&#x20;

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FqDfyjDE8lRRWsKXn7Fh3%2FScreenshot%202025-10-28%20at%2016.56.32.png?alt=media&#x26;token=7d34f89e-6786-4cc5-bfc8-c01306a8ff8d" alt=""><figcaption></figcaption></figure>

* В конверсиях появляется автоцель "Chat" (её создаёт сама Метрика): <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FzhnDrWaYjvoPZo9qCrRT%2F1-1%202.png?alt=media&#x26;token=193f0e90-963f-461c-97a1-28338dc05152" alt=""><figcaption></figcaption></figure>

* Видны посетители сайта: <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FDVdu9hJo8FLEkrssIAkE%2F1-1%203.png?alt=media&#x26;token=5b4efeb2-c606-4c2f-b86e-12f36d9ecf68" alt=""><figcaption></figcaption></figure>

* В отчётах по посетителям сайта видно действие — *переход в чат:* <br>

  <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FgIEHHVORlmws9ox7qDKK%2F1-1%204.png?alt=media&#x26;token=96a0bf38-3cbf-4992-8ff8-4653e02e0568" alt=""><figcaption></figcaption></figure>

Зная **ClientID** и **ChatID**, можно связать данные Метрики с конкретным чатом в CRM и отследить, с каким клиентом велось общение.

***

### ⚙️ Как подключить интеграцию

{% hint style="danger" %}

### Для работы интеграции подключите к своему сайту [Аналитику](https://docs.radist.online/radist.online-docs/nashi-produkty/radist-web/analitika)

{% endhint %}

1. Перейдите в раздел **Интеграции** в личном кабинете Radist.Online.
2. В списке "**Доступные**" найдите интеграцию **«Яндекс Метрика»** и нажмите на неё: <br>

   <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2Fg7gQ1O1bG89jIRWNXN0r%2FScreenshot%202025-10-28%20at%2017-05-44.png?alt=media&#x26;token=bea05b3b-ef09-4737-9d9d-4d0de9563eb9" alt=""><figcaption></figcaption></figure>
3. Нажмите кнопку **«Войти с Яндекс ID»** — откроется окно авторизации Яндекса. <br>

   <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2Fif1n7rfLxhkaW08IxnmN%2Fimage.png?alt=media&#x26;token=e269e561-3d0e-4e76-a230-69b5d2f0880f" alt=""><figcaption></figcaption></figure>
4. После успешной авторизации интеграция создаётся автоматически.
5. Выберите нужный **счётчик Метрики** из выпадающего списка.
6. Нажмите **«Сохранить изменения»** — интеграция активируется. <br>

   <figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FGlMCeLsteT9fG7YXKQHH%2FScreenshot%202025-10-28%20at%2017.54.55.png?alt=media&#x26;token=064860a1-1c71-4d6a-9928-c6384e57d11c" alt=""><figcaption></figcaption></figure>

***

### ⚠️ Возможные ситуации и решения

#### Пустой список счётчиков

Если в выпадающем списке счётчиков у выбранного счётчика отсутствует название в Яндекс Метрике, система автоматически отображает его ID.<br>

Узнать ID счётчика вы можете в настройках соответствующего счётчика в Яндекс.Метрике.

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FoT7Fq5ysHx2CH37aezmX%2FScreenshot%202025-12-09%20at%2010.58.56.png?alt=media&#x26;token=b714ad10-34c7-4ef0-8da3-57503f904f8a" alt=""><figcaption></figcaption></figure>

***

#### Ошибка подключения

Если появляется сообщение об ошибке или кнопка повторной авторизации:

1. Нажмите **«Войти с Яндекс ID»** ещё раз.
2. Повторно выберите нужный счётчик.
3. Сохраните изменения.

***

#### Когда требуется повторная авторизация

Повторная авторизация может понадобиться, если:

* при создании новой интеграции не удалось подключиться к Метрике;
* интеграция потеряла соединение (например, пользователь вышел из Яндекс ID);
* интеграция не использовалась более **1 месяца**.

После повторной авторизации можно выбрать новый счётчик из обновлённого списка.&#x20;

<figure><img src="https://2086500725-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MXlY6zVfZf9OqBmsNV0%2Fuploads%2FwPbwz88sU8ye7c7bAUVI%2FScreenshot%202025-10-28%20at%2018.00.50.png?alt=media&#x26;token=6af01664-b63e-42ca-a4c6-d14831e766e5" alt=""><figcaption></figcaption></figure>

***

#### Удаление счётчика

Если счётчик был удалён в Яндекс Метрике — интеграция перестанет работать.\
Чтобы восстановить передачу данных:

1. Перейдите в настройки интеграции в Radist.Online.
2. Выберите другой активный счётчик.\
   \
   При открытии страницы интеграции в RW нужно поменять счетчик на другой, так как при текущей настройке с удаленным счетчиком не получает данные и события.<br>
3. Сохраните изменения.

***