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

## Описание

{% hint style="success" %}
На вашем сайте должна быть подключена Яндекс.Метрика
{% endhint %}

При использовании функционала **«Чат на сайт»** сервиса **Nextbot** вы можете интегрировать Яндекс.Метрику для более глубокой аналитики пользовательских взаимодействий. Это даёт следующие возможности:

* Отслеживание целей
* Сбор параметров пользователей ИИ-агентом
* Сбор параметров сессий пользователей ИИ-агентом

## Подключение

1. Найдите номер счётчика в личном кабинете [Яндекс.Метрики](https://metrika.yandex.ru/)\ <br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FsyFW5DnrDhIDtEpY969O%2Fimage.png?alt=media&#x26;token=c5deee2c-6248-4da9-b7c7-45b7d00f5c8e" alt=""><figcaption></figcaption></figure>
2. Перейдите в раздел **Интеграции →** [**Яндекс Метрика**](https://app.nextbot.ru/integrations?tab=YandexMetrikaSettings)
3. Введите номер счётчика и нажмите **«Подключить»**.<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FERMccko4qMka0jzVZ1XN%2Fimage.png?alt=media&#x26;token=17b5eb78-ac9f-4760-8a90-113db7b7e1b4" alt=""><figcaption></figcaption></figure>

После этого необходимо настроить **чат на сайт** и создать одну или несколько функций в зависимости от задач.

## Настройка Чата на сайт

### Если чат уже создан

Если у вас уже есть чат на сайт и вы хотите добавить интеграцию с **Яндекс.Метрикой**, необходимо добавить параметр:

```html
ymCounterId: "123456789"
```

См. пример на скриншоте.<br>

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FuoE1cebmf7uZD5sW8DIu%2Fimage.png?alt=media&#x26;token=69217189-d44a-4203-b2ae-c3f72e6748c2" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Важно:** добавьте запятую после параметра, под которым вы вставляете `ymCounterId`.
{% endhint %}

### Новый чат

1. Перейдите в раздел [Чат на сайт](https://app.nextbot.ru/socials?tab=EmbeddedChatSettings\&subtab=widget)
2. Нажмите **«Создать чат»**.
3. Настройте параметры
4. Нажмите **«Встроить на сайт»** и следуйте инструкциям

Если интеграция с Яндекс.Метрикой уже настроена, в коде для встраивания будет автоматически добавлен параметр:

```
ymCounterId: "123456789"
```

## Фиксирование Целей

{% hint style="info" %}
Работает только для целей типа **JavaScript-событие**.
{% endhint %}

**Пример:** у вас есть функция `save_lead_info` для сохранения данных потенциального клиента, которая отправляет заявки в Telegram. К этой же функции можно подключить и Яндекс.Метрику

Для фиксации целей через чат на сайте выполните следующие шаги:

1. В **Яндекс.Метрике** создайте цель с типом **«JavaScript-событие»**.
2. Присвойте цели идентификатор. В нашем примере — `test_widget`.<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FtmOZilTdxqbYBprN6kuV%2Fimage.png?alt=media&#x26;token=c9c54aba-fce1-4e39-9813-e4818230ca57" alt=""><figcaption></figcaption></figure>
3. Перейдите в раздел [**Функции.**](https://app.nextbot.ru/functionsGPT)
4. Убедитесь, что использование функций включено
5. Найдите свою функцию, в нашем примере `save_lead_info`<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FE8OOaP0vfCBTnWzM3ZES%2Fimage.png?alt=media&#x26;token=68ff9f4b-9698-4b69-a7b2-6f43291465d7" alt=""><figcaption></figcaption></figure>
6. Пролистайте вниз до раздела Действи&#x44F;**:**
   * Нажмите **«Добавить действие»**
   * Выберите опцию **Yandex Metrika**.
   * Перейдите в соответствующий подраздел.
7. В выпадающем списке **«Действие»** выберите вариант:
   * **«Вызвать целевое событие и записать параметры»**.
8. Введите **идентификатор цели** — в нашем примере: `test_widget`.<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fjw2cAlThOjU0lHwQMTod%2Fimage.png?alt=media&#x26;token=40f4f17a-ea3a-4c77-83cd-d441c1d7a419" alt=""><figcaption></figcaption></figure>
9. Сохраните функцию
10. Протестируем\
    \
    ![](https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FLpc1L3gVtQH4Vzv8AECw%2Fimage.png?alt=media\&token=62d306a7-ff7b-4666-8277-88d8bae044f9)
11. Проверим в диалогах\
    \
    ![](https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FKxD1FdpWjWdOTORFv5Pp%2Fimage.png?alt=media\&token=bbea6100-aec6-43f9-b511-148bc46dd2c7)
12. Проверим фиксацию цели в Яндекс.Метрике<br>

    <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F0M4oLMvFT5Bk18B8Q1ye%2Fimage.png?alt=media&#x26;token=ce29d851-7dcb-4b57-84c8-e835f974d8a9" alt=""><figcaption></figcaption></figure>

## Получение данных в отчеты **«Параметры визитов» или «Параметры посетителей»**

Для передачи данных в отчеты в **Яндекс.Метрику** из **чата на сайт** можно подключить функционал передачи к существующей функции. Если же функций нет - создать соответствующую.

**Пример:** у вас есть функция `save_lead_info` для сохранения данных потенциального клиента, которая отправляет заявки в Telegram. К этой же функции можно подключить и Яндекс.Метрик, но в этом примере, я покажу настройки для отправки данных в другие отчеты.

**Приступим:**

1. Перейдите в раздел [**Функции**.](https://app.nextbot.ru/functionsGPT)
2. Убедитесь, что использование функций включено
3. Найдите свою функцию, в нашем примере save\_lead\_info<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F6sqMFq6ri9yzKubO7DNL%2Fimage.png?alt=media&#x26;token=f2417ff5-2b8d-4e41-878a-94e0186f1b87" alt=""><figcaption></figcaption></figure>
4. Добавьте параметр функции с именем **traffic\_source**.<br>

   <figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FJQ15IslHAJpm9loyzay1%2Fimage.png?alt=media&#x26;token=a5065cbd-f95f-457b-96df-496e1e6e414b" alt=""><figcaption></figcaption></figure>
5. Пролистайте вниз до раздела **Действия:**
   * Нажмите **«Добавить действие»**
   * Выберите опцию **Yandex Metrika**.
   * Перейдите в соответствующий подраздел.
6. В выпадающем списке **«Действие»** выберите нужный вариант:
   * **Записать параметры сессии пользователя** - данные попадут в отчёт **«Параметры визитов»** в Яндекс.Метрике.
   * **Записать постоянные параметры пользователя** - Данные попадут в отчёт **«Параметры посетителей»**.
7. В разделе **«Параметры»** добавьте параметр для передачи в Яндекс.Метрику:
   * Имя параметра: **Источник трафика**
   * Действие: **параметр из функции**
   * Передаваемое значение: **traffic\_source**

<figure><img src="https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2F7dipZ5gvj8Qc3TpoJeuF%2Fimage.png?alt=media&#x26;token=2e66a20e-8562-45f7-b469-b1db31a02f1a" alt=""><figcaption></figcaption></figure>

8. Сохраните изменения в функции.
9. Проведём тестовое общение\
   \
   ![](https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2FSuipz45kyaxhX5vPtXM0%2Fimage.png?alt=media\&token=477552cd-a6e8-4028-a478-45d6c35b5a88)
10. Проверим в диалоге.\
    \
    ![](https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Flmm1oGSRtL3Wwdpygwdg%2Fimage.png?alt=media\&token=75ac7d03-a32a-402a-9a14-7797f8b2c89f)
11. Проверим в отчете в Яндекс.Метрике\
    ![](https://2593311972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fef2EBU68XAlye1NtG8DF%2Fuploads%2Fgy2txy0ITZb5uyHFZNPM%2Fimage.png?alt=media\&token=6c1ddee8-3e09-41dc-8326-ff8f96315f69)