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

Инструкция для специалиста, который настраивает аналитику сайта. После настройки в Метрике появятся цели: открытие чата, обращение, заявка на звонок. Их можно использовать в отчётах и передавать в Яндекс.Директ как конверсии.

Содержание

Как это работает
Настройка в Linea
Создание целей в Метрике
Список событий
Проверка
Связка с Директом
GTM и свои события
Частые проблемы

1. Как это работает

Виджет Linea вызывает стандартный метод Метрики ym(ID, 'reachGoal', 'имя_цели') в момент действия посетителя. Никакого отдельного счётчика и никакой синхронизации по API не требуется — события уходят из браузера так же, как если бы вы расставили вызовы вручную.

По умолчанию используется счётчик, уже установленный на сайте. Виджет находит глобальную функцию ym и работает через неё. Если Метрики на сайте нет, Linea может подключить счётчик самостоятельно.

Что не передаётся. В Метрику уходит только имя цели и обезличенные параметры (страница, тип действия). Тексты сообщений, имена, телефоны и email посетителей не передаются никогда.

2. Настройка в Linea

Откройте настройки сайта. Панель Linea → Сайты → нужный сайт → вкладка Метрика.
Включите передачу событий переключателем «Передавать события в Яндекс.Метрику».
Укажите номер счётчика. Его видно в Метрике: Настройки → Счётчик → Номер. Это 8–9 цифр, например 87654321.
Выберите, где взять счётчик.
- Уже стоит на сайте — рекомендуемый вариант.
- Подключить виджетом — только если Метрики на сайте нет. Иначе получите два счётчика и задвоение визитов.
Отметьте нужные цели в списке ниже на той же вкладке. Минимально достаточный набор: открытие чата, первое сообщение, контакты, заявка на звонок.
Нажмите «Сохранить» в правом верхнем углу и скопируйте список идентификаторов целей кнопкой «Скопировать список» — он понадобится на следующем шаге.

Префикс имён целей. По умолчанию linea_. Он нужен, чтобы цели чата не смешивались с вашими. Менять его после того, как цели созданы в Метрике, не следует: статистика по старым именам перестанет пополняться.

3. Создание целей в Метрике

Цели в Метрике не создаются автоматически — их нужно завести один раз вручную.

Откройте metrika.yandex.ru и выберите нужный счётчик.
Перейдите в Настройки → Цели и нажмите Добавить цель.
Название — любое понятное вам, например «Чат: обращение».
Тип условия — JavaScript-событие.
В поле Идентификатор цели вставьте имя из списка, скопированного в Linea, например linea_first_message.
Сохраните. Повторите для каждой цели, которую включили в Linea.

Идентификатор в Метрике должен совпадать с именем цели в Linea посимвольно, включая префикс. Это самая частая причина, по которой цели остаются пустыми.

4. Список событий

Имена приведены с префиксом по умолчанию. Если вы его изменили — подставьте свой.

Идентификатор	Когда срабатывает	Свои параметры
`linea_open`	Посетитель раскрыл окно чата	—
`linea_first_message`	Отправлено первое сообщение в диалоге. Основная цель	—
`linea_message`	Каждое сообщение посетителя	—
`linea_contact`	Заполнена форма контактов	`has_name`, `has_phone`, `has_email`
`linea_callback`	Отправлена заявка на обратный звонок	`source`: `banner`, если заявка из баннера
`linea_rating`	Посетитель оценил консультацию	`value`: `up` / `down`
`linea_operator_reply`	Оператор ответил в диалоге	—
Служебные — по умолчанию выключены, включаются одним переключателем «Показы приглашений»
`linea_invite_shown`	Показано приглашение по триггеру	`trigger` — название приглашения
`linea_invite_click`	Нажата кнопка в приглашении	`text` — надпись кнопки
`linea_attention_shown`	Посетителя окликнули: приветствие, приглашение или баннер	`kind` — что именно сработало
`linea_callback_banner_shown`	Показан баннер обратного звонка	—

Параметры, которые приходят с каждой целью

Кроме собственных параметров из таблицы, к любой цели добавляются сведения о визите. Без них в отчёте видно «сколько раз», но не «в каких условиях».

Параметр	Значение	Зачем
`page`	адрес страницы без домена	видно, с каких страниц пишут чаще
`product`	название товара со страницы	какие карточки порождают вопросы; берётся из разметки, которая уже стоит для поисковых сниппетов
`visit`	`first` или `repeat`	первый визит или повторный: поведение и ценность разные
`online`	`yes` или `no`	работали ли операторы; иначе «плохая конверсия» объясняется просто ночью

В Метрике эти параметры видны в отчёте «Цели» при переходе к параметрам визита, а также доступны в сегментах: например, «обращения с карточек товаров в нерабочее время».

Цели linea_open и linea_message срабатывают часто и заметно «шумят» в отчётах. Если вы строите воронку или передаёте конверсии в Директ, берите за целевое действие linea_first_message, linea_contact или linea_callback.

Каждая цель, кроме linea_message, отправляется один раз за визит — повторное открытие чата не накручивает конверсии.

5. Проверка

Быстрая проверка в браузере

Откройте сайт и консоль разработчика (F12).
Выполните Linea.status() — в ответе должны быть заполнены metrika (номер счётчика) и metrikaReady: true.
Откройте чат и напишите тестовое сообщение.
Выполните команду ниже — она покажет все цели, которые отправляет виджет:

window.addEventListener('linea:goal', e => console.log('Цель:', e.detail.goal, e.detail.params));

Проверка в Метрике

Отчёт Отчёты → Стандартные отчёты → Конверсии показывает достижения целей с задержкой. Быстрее всего — Вебвизор или отчёт По времени суток с фильтром по цели: данные появляются в течение нескольких минут.

Если metrikaReady равно false, виджет не нашёл на странице функцию ym. Обычно это значит, что счётчик Метрики стоит ниже виджета, подключается через блокируемый домен или отсутствует. См. раздел «Частые проблемы».

6. Связка с Яндекс.Директом

После того как цели заведены и начали накапливать данные, их можно использовать как конверсии в рекламных кампаниях:

в Директе выберите стратегию с оптимизацией по конверсиям;
в качестве цели укажите linea_first_message или linea_callback;
задайте ценность конверсии, если считаете экономику по лидам.

Виджет сохраняет метки utm_source, utm_medium, utm_campaign, yclid и gclid вместе с визитом, поэтому в карточке диалога оператор видит, из какой кампании пришёл человек. Это позволяет сверять данные Метрики с реальными обращениями.

7. GTM и собственные события

Каждая цель дублируется в dataLayer — можно ловить в Google Tag Manager:

// В GTM: триггер «Пользовательское событие», имя события linea_first_message
dataLayer.push({ event: 'linea_first_message', linea: { page: '/catalog' } });

И отдаётся как DOM-событие для произвольной обработки:

window.addEventListener('linea:goal', function (e) {
  // e.detail.goal   — полное имя цели, например linea_callback
  // e.detail.name   — короткое имя, например callback
  // e.detail.params — параметры цели
  myAnalytics.track(e.detail.goal, e.detail.params);
});

Отправить свою цель через счётчик, настроенный в Linea:

Linea.goal('promo_clicked', { block: 'hero' });
// уйдёт в Метрику как linea_promo_clicked

Имя объекта. Доступны оба варианта: Linea и LineaChat — это один и тот же объект. Второй остался для совместимости с ранними интеграциями.

8. Частые проблемы

Цели созданы, но остаются пустыми

Идентификатор в Метрике не совпадает с именем в Linea — проверьте префикс и опечатки.
Тип условия цели выбран не «JavaScript-событие».
Настройки в Linea изменены, но не нажата кнопка «Сохранить».
Цель отключена переключателем на вкладке «Метрика».

metrikaReady: false

Счётчика Метрики на странице нет — переключите режим на «Подключить виджетом».
Код Метрики загружается дольше 15 секунд — перенесите его выше в <head>.
Блокировщик рекламы в браузере вырезал mc.yandex.ru. Проверьте в режиме инкогнито с отключёнными расширениями.

Визиты задвоились

На сайте одновременно работают счётчик из вёрстки и счётчик, подключённый виджетом. Переключите режим на «Уже стоит на сайте».

Конверсий сильно больше, чем обращений в панели

Скорее всего включена цель linea_message — она срабатывает на каждое сообщение. Для подсчёта обращений используйте linea_first_message.

Нужно передавать данные в другую систему аналитики

Используйте событие linea:goal из раздела 7 — оно не зависит от Метрики и срабатывает всегда, когда виджет фиксирует действие.

Не получилось настроить? Напишите в поддержку — приложите номер счётчика, адрес сайта и вывод Linea.status() из консоли.