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

## Описание

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

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

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

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

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

   <figure><img src="/files/uRX8WTMa3fxWhlHWoqtA" alt=""><figcaption></figcaption></figure>
2. Перейдите в раздел **Интеграции →** [**Яндекс Метрика**](https://app.nextbot.ru/integrations?tab=YandexMetrikaSettings)
3. Введите номер счётчика и нажмите **«Подключить»**.<br>

   <figure><img src="/files/Ok92AxUnIAtocG1bZuxX" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

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

<figure><img src="/files/ypgz2DeVDBlGFqKaU31i" 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="/files/vtKu32RnNTIKWfE5C5xE" alt=""><figcaption></figcaption></figure>
3. Перейдите в раздел [**Функции.**](https://app.nextbot.ru/functionsGPT)
4. Убедитесь, что использование функций включено
5. Найдите свою функцию, в нашем примере `save_lead_info`<br>

   <figure><img src="/files/PhLkaloRZM2R73thlqAH" alt=""><figcaption></figcaption></figure>
6. Пролистайте вниз до раздела Действи&#x44F;**:**
   * Нажмите **«Добавить действие»**
   * Выберите опцию **Yandex Metrika**.
   * Перейдите в соответствующий подраздел.
7. В выпадающем списке **«Действие»** выберите вариант:
   * **«Вызвать целевое событие и записать параметры»**.
8. Введите **идентификатор цели** — в нашем примере: `test_widget`.<br>

   <figure><img src="/files/XF87C9dCAPHYtJtieYvr" alt=""><figcaption></figcaption></figure>
9. Сохраните функцию
10. Протестируем\
    \
    ![](/files/3aNUvfIYeVvr1hVbA518)
11. Проверим в диалогах\
    \
    ![](/files/hgMonfE8LZfGqC38G4xv)
12. Проверим фиксацию цели в Яндекс.Метрике<br>

    <figure><img src="/files/oGrDKJyFQA8LYFGiBj6I" alt=""><figcaption></figcaption></figure>

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

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

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

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

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

   <figure><img src="/files/RRBYNoGkd64SgeIViIGM" alt=""><figcaption></figcaption></figure>
4. Добавьте параметр функции с именем **traffic\_source**.<br>

   <figure><img src="/files/F5Dt9Kqb4fOoxEBvYZWv" alt=""><figcaption></figcaption></figure>
5. Пролистайте вниз до раздела **Действия:**
   * Нажмите **«Добавить действие»**
   * Выберите опцию **Yandex Metrika**.
   * Перейдите в соответствующий подраздел.
6. В выпадающем списке **«Действие»** выберите нужный вариант:
   * **Записать параметры сессии пользователя** - данные попадут в отчёт **«Параметры визитов»** в Яндекс.Метрике.
   * **Записать постоянные параметры пользователя** - Данные попадут в отчёт **«Параметры посетителей»**.
7. В разделе **«Параметры»** добавьте параметр для передачи в Яндекс.Метрику:
   * Имя параметра: **Источник трафика**
   * Действие: **параметр из функции**
   * Передаваемое значение: **traffic\_source**

<figure><img src="/files/qBS08rOyhBr24rnqVlmt" alt=""><figcaption></figcaption></figure>

8. Сохраните изменения в функции.
9. Проведём тестовое общение\
   \
   ![](/files/bFjtbc2YtB8lB7x4KPjo)
10. Проверим в диалоге.\
    \
    ![](/files/CKGgOz4e3SHMZ909dtN8)
11. Проверим в отчете в Яндекс.Метрике\
    ![](/files/0H1z6SBheFXLlPHIjb3q)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.nextbot.ru/functional/integrations/yandeks.metrika.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.