Интеграция с Яндекс.Метрикой

StatMX решает ключевую проблему рекламы каналов MAX — передачу конверсий подписки обратно в Яндекс.Директ. Без этого рекламная система не знает, какие клики привели к подписке, и не может оптимизировать кампанию.

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

Полная цепочка от клика по рекламе до конверсии:

1. Пользователь кликает по рекламе в Яндекс.Директ → попадает на лендинг с ?yclid=xxx
2. Пиксель StatMX на лендинге перехватывает yclid и отправляет в StatMX
3. Пользователь кликает по кнопке → переходит в бота MAX
4. При подписке на канал StatMX связывает подписку с yclid
5. Конверсия отправляется в Яндекс.Метрику через Offline Conversions API
6. Яндекс.Директ видит конверсию и оптимизирует рекламу

Шаг 1. Подключите Яндекс.Метрику

1. Отправьте боту команду /settings
2. Выберите канал
3. Нажмите Подключить Яндекс.Метрику
4. Бот откроет страницу авторизации Яндекса — разрешите доступ
5. Введите номер счётчика Яндекс.Метрики

Кто может подключать: владелец канала и назначенные администраторы проекта (ProjectAdmin).

Шаг 2. Автосоздание целей

После подключения счётчика StatMX автоматически создаёт три цели в Яндекс.Метрике:

Цель	Что отслеживает
statmx_click	Клик по кнопке на лендинге
statmx_open	Открытие бота после перехода
statmx_subscribe	Подписка на канал

Если цели с такими именами уже существуют — бот использует их, не создавая дубликаты.

Шаг 3. Создайте ссылку с Метрикой

Используйте команду /ylink для создания ссылки с привязкой к Метрике. В отличие от обычного /link, эта ссылка:

• Генерирует JavaScript-пиксель для вашего лендинга
• Автоматически отслеживает yclid из Яндекс.Директа
• Передаёт конверсии в Метрику при подписке

Шаг 4. Установите пиксель на лендинг

После создания /ylink бот выдаст код пикселя — его нужно установить на лендинг. Подробная инструкция — в разделе Пиксель на лендинг.

Настройка Яндекс.Директ

Чтобы Яндекс.Директ оптимизировал рекламу по конверсиям подписки:

1. В кампании Директа выберите стратегию «Оптимизация конверсий»
2. Укажите цель statmx_subscribe как целевое действие
3. Задайте целевую стоимость конверсии (CPA)

Директ начнёт обучаться на данных о подписках и показывать рекламу аудитории, которая с большей вероятностью подпишется.

Как отправляются конверсии

StatMX использует Offline Conversions API Яндекс.Метрики:

• Конверсия отправляется сразу при подписке — без задержки
• Если отправка не удалась — scheduler повторяет попытку каждые 5 минут
• Формат: CSV с полями UserId, Target, DateTime, Price, Currency
• Привязка по yclid — уникальному идентификатору клика из Директа

Что дальше

• Пиксель на лендинг — установка кода отслеживания
• Начало работы — если ещё не подключили бота