Яндекс.Метрика для сайта
К сайту, созданному в Salebot, можно подключить Яндекс.Метрику.
Для этого:
- создайте счетчик в Яндекс.Метрике;
- создайте цели;
- укажите данные счетчика в настройках сайта.


Поле «ID Яндекс Метрики» предназначено для указания идентификатора счетчика.
Как создать счетчик Яндекс.Метрики
Для передачи офлайн-конверсий из Salebot необходимо создать счетчик в Яндекс.Метрике.
Если счетчика еще нет
- Войдите в аккаунт Яндекса или зарегистрируйте новый.
- Перейдите в Яндекс.Метрику.
- Нажмите «Добавить счетчик».

При создании счетчика заполните следующие поля:
- Имя счетчика.
- Адрес сайта.
В примере используется сайт Salebot.

Рекомендуется включить:
- Автоматические цели;
- Вебвизор;
- Карту скроллинга;
- Аналитику форм.

После заполнения формы нажмите «Создать счетчик».
Как установить счетчик на сайт
После создания счетчика откроется страница с кодом счетчика.
Скопируйте HTML-код и нажмите «Начать пользоваться».

Если счетчик уже существует, его код можно открыть в настройках счетчика.

После этого откройте настройки сайта в Salebot.

Перейдите:
Настройки → HTML
и вставьте код счетчика в одно из полей:
- HTML-код head;
- HTML-код body.

После этого нажмите «Сохранить».
Создание константы проекта
Откройте Яндекс.Метрику и скопируйте ID счетчика.

Затем в Salebot создайте константу проекта:
ym_counter_id


Если счетчик уже существует
Если Яндекс.Метрика уже используется, создавать новый счетчик не нужно.
Достаточно:
- открыть существующий счетчик;
- скопировать его ID;
- записать его в константу проекта:
ym_counter_id
После этого можно переходить к настройке целей.
Подключение по ID
Для подключения Метрики достаточно указать ID счетчика в настройках сайта.

ID можно посмотреть в разделе «Обзор» рядом с названием счетчика.


Укажите ID в поле «ID Яндекс Метрики».
Добавление ID счетчика равнозначно установке кода счетчика на сайт.
Настройка целей
После подключения счетчика создайте одну или несколько целей в Яндекс.Метрике.
Шаг 1. Создание цели
Перейдите в раздел «Цели» и нажмите «Добавить цель».


Шаг 2. Выберите тип цели
Выберите тип цели «JS-событие».

После этого заполните поля:
- Название;
- Идентификатор цели.

Поле «Название» можно заполнить произвольным текстом.
В поле «Идентификатор цели» необходимо указать идентификатор, который затем будет использоваться в настройках сайта.

Если указать идентификатор без дополнительных символов, цель будет срабатывать при нажатии на любую кнопку сайта.
Отдельные цели для разных кнопок
Если необходимо отслеживать клики по каждой кнопке отдельно, идентификатор цели должен заканчиваться символом нижнего подчеркивания:
_
Например:
click_button_
После этого Salebot автоматически будет добавлять индекс мессенджера.
Например:
| Идентификатор | Событие |
|---|---|
click_button_0 |
ВКонтакте |
click_button_1 |
Telegram |
click_button_2 |
Viber |
click_button_3 |
Facebook* |
click_button_6 |
WhatsApp* |
click_button_8 |
Одноклассники |
click_button_10 |
Instagram* |
click_button_20 |
MAX |
* Facebook, Instagram и WhatsApp принадлежат Meta Platforms Inc., деятельность которой признана экстремистской и запрещена на территории РФ.
Сам идентификатор может быть любым.
Главное условие — наличие символа _ в конце.

Ниже показан пример правильно созданной цели и соответствующих настроек сайта.


Настройка событий для кнопок
Чтобы отправлять события в Метрику при отправке формы или переходе в мессенджер, откройте настройки сайта.

Наведите курсор на блок «Форма» и нажмите «Настройки».

Раскройте настройки кнопок.

В поле события укажите идентификатор цели, созданной в Яндекс.Метрике.

Чтобы события отправлялись в Яндекс.Метрику, код счетчика должен быть установлен на сайте.
Аналогичным образом можно настроить события для каждой кнопки мессенджера.



Передача офлайн-конверсий в Яндекс.Метрику
Важно
Передача офлайн-конверсий выполняется по идентификатору клиента Яндекс.
Если у клиента присутствует системная переменная
_ym_uid, она автоматически используется для передачи статистики.После запуска бота должно пройти некоторое время (обычно 5–10 минут), чтобы
_ym_uidуспел попасть в Яндекс.Метрику.

Переменная _ym_uid
_ym_uid — это уникальный идентификатор посетителя (Client ID), который автоматически присваивается Яндекс.Метрикой каждому пользователю.
Если у клиента отсутствует переменная _ym_uid, статистика по нему передаваться не будет.
Если идентификатор известен заранее, можно использовать пользовательскую переменную:
ya_client_id
В этом случае Salebot будет использовать именно ее.
Если клиента с указанным значением
ya_client_idнет в Яндекс.Метрике, событие не будет обработано.

Если клиент с переменной _ym_uid проходит необходимые этапы сценария, Salebot отправляет данные в Яндекс.Метрику.
Статус обработки можно посмотреть в Яндекс.Метрике:
Настройки счетчика → Загрузка данных
Важно
Обработка данных может занимать до 24 часов.
После успешной обработки появится статус «Выполнено».
Если обработка завершилась ошибкой, Яндекс.Метрика не смогла найти клиента с указанным
_ym_uid.
Measurement Protocol
Для передачи событий необходим секретный токен Measurement Protocol.
Откройте настройки нужного счетчика.

Прокрутите страницу вниз и откройте раздел «Дополнительные настройки».

Затем откройте раздел:
Безопасность и использование данных → Measurement Protocol

Включите опцию Measurement Protocol и скопируйте сгенерированный токен.

Сохраните его в константу проекта:
ym_measurement_token

Функция ym_event()
Для передачи событий в Яндекс.Метрику используется функция:
ym_event(
event,
client_id_type,
page_url,
counter_id,
measurement_token
)
Функция отправляет событие (конверсию) в Яндекс.Метрику.
Параметры
| Параметр | Описание |
|---|---|
| event | Обязательный параметр. Идентификатор цели (событие), которое необходимо отправить в Яндекс.Метрику. |
| client_id_type | Необязательный параметр. Позволяет выбрать способ идентификации пользователя. Передайте значение yclid, чтобы использовать идентификатор yclid. Во всех остальных случаях используется _ym_uid. |
| page_url | Адрес сайта. Обязателен, если в настройках счетчика включена опция «Принимать данные только с указанных адресов». |
| counter_id | Идентификатор счетчика Яндекс.Метрики. Используется при работе с несколькими счетчиками. Если параметр не передан, будет использовано значение константы проекта ym_counter_id. |
| measurement_token | Секретный токен Measurement Protocol. Используется при работе с несколькими счетчиками. Если параметр не передан, будет использовано значение константы проекта ym_measurement_token. |
Важно
Если параметры
counter_idиmeasurement_tokenпереданы в функцию, они имеют приоритет над значениями, указанными в настройках проекта.