← Инструкция по интеграциям
Яндекс Метрика
# 📊 Интеграция с Яндекс Метрикой
## Обзор
Интеграция с Яндекс Метрикой позволяет автоматически отслеживать показы виджетов и отправку форм (лидов) в вашей системе аналитики. Вы сможете видеть, какие виджеты показываются пользователям и какие из них приводят к конверсиям.
## Что отслеживается
### 1. Показы виджетов
- **Общее событие**: `genium_show_send` - отправляется при показе любого виджета
- **Событие для конкретного виджета**: `genium_widget_show_{ID}` - где `{ID}` это уникальный идентификатор настройки виджета
### 2. Отправка форм (лиды)
- **Общее событие**: `genium_lead_send` - отправляется при отправке формы в любом виджете
- **Событие для конкретного виджета**: `genium_widget_lead_{ID}` - где `{ID}` это уникальный идентификатор настройки виджета
---
## 📋 Пошаговая настройка
### Шаг 1: Получение номера счетчика Яндекс Метрики
1. Войдите в ваш аккаунт [Яндекс Метрики](https://metrika.yandex.ru/)
2. Выберите нужный счетчик или создайте новый
3. Перейдите в **Настройки** → **Код счетчика**
4. Найдите номер счетчика в коде. Он выглядит так:
```html
```
5. Скопируйте номер счетчика (в примере это `12345678`)
**Важно**: Номер счетчика - это числовое значение, которое передается в функцию `ym()` первым параметром.
---
### Шаг 2: Настройка интеграции в панели управления
1. Войдите в вашу панель управления виджетами
2. Перейдите в раздел **Настройки** → **Интеграции**
3. Найдите секцию **Яндекс Метрика**
4. Включите интеграцию, переключив переключатель **Включено**
5. Введите номер счетчика в поле **Номер счетчика**
6. Нажмите кнопку **Сохранить**
**Пример заполнения:**
```
Номер счетчика: 12345678
```
---
### Шаг 3: Создание целей в Яндекс Метрике
После настройки интеграции необходимо создать цели в Яндекс Метрике для отслеживания событий.
#### 3.1. Создание цели для всех виджетов (показы)
1. В Яндекс Метрике перейдите в **Настройки** → **Цели**
2. Нажмите **Добавить цель**
3. Выберите тип цели: **JavaScript-событие**
4. Заполните параметры:
- **Название цели**: `Показ виджета (все)`
- **Идентификатор цели**: `genium_show_send`
5. Нажмите **Сохранить**
#### 3.2. Создание цели для всех виджетов (лиды)
1. В разделе **Цели** нажмите **Добавить цель**
2. Выберите тип: **JavaScript-событие**
3. Заполните:
- **Название цели**: `Отправка формы (все виджеты)`
- **Идентификатор цели**: `genium_lead_send`
4. Нажмите **Сохранить**
#### 3.3. Создание цели для конкретного виджета (опционально)
Если вы хотите отслеживать показы и лиды по отдельным виджетам:
1. **Узнайте ID настройки виджета:**
- Перейдите в настройки нужного виджета
- Посмотрите в адресной строке браузера
- ID находится в URL после последнего слеша, например: `/widgets/123/edit`
- В этом случае ID = `123`
2. **Создайте цель для показа виджета:**
- Тип: **JavaScript-событие**
- Название: `Показ виджета #123`
- Идентификатор: `genium_widget_show_123` (где `123` - ваш ID виджета)
3. **Создайте цель для лида виджета:**
- Тип: **JavaScript-событие**
- Название: `Лид с виджета #123`
- Идентификатор: `genium_widget_lead_123` (где `123` - ваш ID виджета)
**Важно**: Замените `123` на реальный ID вашего виджета!
---
### Шаг 4: Проверка работы интеграции
#### 4.1. Проверка в реальном времени
1. Откройте сайт, на котором установлены виджеты
2. В Яндекс Метрике перейдите в **Отчеты** → **В реальном времени**
3. Выполните действие, которое должно вызвать событие:
- Покажите виджет (например, покиньте страницу для exit intent виджета)
- Отправьте форму в виджете
4. В отчете "В реальном времени" должны появиться события с вашими идентификаторами целей
#### 4.2. Проверка через консоль браузера
1. Откройте консоль разработчика (F12)
2. Перейдите на вкладку **Console**
3. Выполните действие с виджетом
4. Вы должны увидеть сообщения вида:
```
[Widget] Отправлена цель Яндекс Метрики: genium_show_send для счетчика: 12345678
```
#### 4.3. Проверка в отчетах
1. В Яндекс Метрике перейдите в **Отчеты** → **Стандартные отчеты** → **Цели**
2. Выберите нужный период
3. Проверьте, что ваши цели регистрируются и показывают данные
---
## 🔍 Устранение неполадок
### События не отправляются
**Проблема**: Цели не регистрируются в Яндекс Метрике
**Решения:**
1. **Проверьте номер счетчика:**
- Убедитесь, что номер счетчика введен правильно
- Номер должен быть числом без пробелов и дополнительных символов
2. **Проверьте, что счетчик Яндекс Метрики установлен на сайте:**
- Код счетчика должен быть добавлен на все страницы сайта
- Функция `ym()` должна быть доступна в глобальной области видимости
3. **Проверьте консоль браузера:**
- Откройте консоль (F12)
- Ищите сообщения об ошибках
- Если видите: `Пропуск отправки цели Яндекс Метрики: функция ym не найдена` - значит счетчик еще не загружен
4. **Проверьте идентификаторы целей:**
- Идентификаторы в Яндекс Метрике должны точно совпадать с теми, что указаны в инструкции
- Регистр имеет значение: `genium_show_send` ≠ `Genium_Show_Send`
### События отправляются, но не видны в отчетах
**Проблема**: В консоли видно отправку событий, но в отчетах их нет
**Решения:**
1. **Проверьте задержку обновления:**
- Данные в стандартных отчетах обновляются с задержкой (обычно 1-2 часа)
- Используйте отчет "В реальном времени" для немедленной проверки
2. **Проверьте фильтры в отчете:**
- Убедитесь, что не установлены фильтры, которые исключают ваши события
- Проверьте выбранный период времени
3. **Проверьте права доступа:**
- Убедитесь, что у вас есть права на просмотр целей в этом счетчике
### Не работает отслеживание конкретного виджета
**Проблема**: Общие события работают, но события для конкретного виджета не регистрируются
**Решения:**
1. **Проверьте ID виджета:**
- Убедитесь, что вы используете правильный ID настройки виджета
- ID можно найти в URL при редактировании виджета
2. **Проверьте идентификатор цели:**
- Формат должен быть: `genium_widget_show_{ID}` или `genium_widget_lead_{ID}`
- Замените `{ID}` на реальный числовой ID без фигурных скобок
---
## 📊 Примеры использования
### Отслеживание эффективности всех виджетов
Создайте две цели:
- `genium_show_send` - для показов
- `genium_lead_send` - для лидов
Это позволит вам видеть:
- Общее количество показов всех виджетов
- Общее количество лидов со всех виджетов
- Общий коэффициент конверсии
### Отслеживание эффективности конкретного виджета
Для виджета с ID `42` создайте:
- `genium_widget_show_42` - показы этого виджета
- `genium_widget_lead_42` - лиды с этого виджета
Это позволит вам:
- Сравнивать эффективность разных виджетов
- Оптимизировать настройки конкретных виджетов
- Анализировать, какие виджеты лучше конвертируют
### Комбинированное отслеживание
Создайте все цели:
- Общие цели для общей статистики
- Индивидуальные цели для каждого важного виджета
Это даст вам полную картину:
- Общую эффективность системы виджетов
- Детальную статистику по каждому виджету
- Возможность сравнивать виджеты между собой
---
## 💡 Рекомендации
### Оптимизация целей
1. **Не создавайте цели для всех виджетов сразу:**
- Начните с общих целей (`genium_show_send`, `genium_lead_send`)
- Добавляйте индивидуальные цели только для важных виджетов
2. **Используйте понятные названия:**
- Названия целей должны быть понятными через месяц
- Пример: `Показ виджета Exit Intent #15` вместо `Показ #15`
3. **Группируйте виджеты:**
- Если у вас много виджетов, создавайте цели только для наиболее важных
- Используйте общие цели для остальных
### Анализ данных
1. **Сравнивайте конверсию:**
- Коэффициент конверсии = (Лиды / Показы) × 100%
- Сравнивайте виджеты с похожими функциями
2. **Отслеживайте тренды:**
- Регулярно проверяйте изменения конверсии
- Анализируйте, какие изменения в настройках влияют на конверсию
3. **Используйте сегментацию:**
- В Яндекс Метрике можно создавать сегменты по целям
- Это поможет анализировать поведение пользователей, которые взаимодействуют с виджетами
---
## 🔐 Безопасность
- Номер счетчика не является секретной информацией
- События отправляются только на сайтах, где установлен код счетчика
- Интеграция работает только если счетчик Яндекс Метрики установлен на сайте
- События не отправляются, если счетчик заблокирован блокировщиками рекламы
---
## 📞 Поддержка
Если у вас возникли проблемы с настройкой интеграции:
1. Проверьте раздел "Устранение неполадок" выше
2. Убедитесь, что все шаги выполнены правильно
3. Проверьте консоль браузера на наличие ошибок
4. Обратитесь в службу поддержки с описанием проблемы