Legan Studio
Все статьи
~ 6 мин чтения

Реферальная программа в боте MAX: механика и метрики

Как сделать рабочую реферальную программу в боте MAX: deeplink, учёт приглашений, антифрод, начисление бонусов. Метрики, которые показывают эффект.

  • MAX
  • продажи
  • конверсия

Реферальная программа в мессенджере работает лучше, чем на сайте: пользователи легко делятся ссылкой, переходы идут с одного клика, бонус начисляется автоматически. Разберём, как собрать рабочий реферальный механизм в боте MAX и какие метрики смотреть.

Базовая механика

Реферальная программа в боте состоит из трёх частей:

  1. Уникальная ссылка для каждого пользователя.
  2. Учёт перехода и регистрации приглашённого.
  3. Начисление бонуса обоим участникам.

Технически уникальная ссылка — это deeplink на бота с параметром: реферер передаётся в команде /start. Bot API MAX, как и Telegram, прокидывает payload запуска в первый апдейт. Бот сохраняет связь «новый пользователь → реферер» в Postgres.

После целевого действия (регистрация, первая покупка, оплата подписки) триггерится начисление: бонус, скидка, бесплатный месяц — что предусмотрено программой.

Виды механик

В зависимости от продукта выбирается одна из схем:

  • Двусторонний бонус: и реферер, и приглашённый получают подарок. Самая универсальная схема, выше виральность.
  • Только пригласившему: бонус начисляется за каждого активного приглашённого. Хорошо работает в B2C-сервисах.
  • Многоуровневая программа: бонусы за приглашённых второго и третьего уровня. Эффективна, но требует контроля антифрода.
  • Турниры и таблицы лидеров: топ рефереров получает крупные призы. Создаёт всплеск активности на короткий срок.

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

Антифрод

Без защиты реферальная программа быстро превращается в источник убытков. Минимальный набор мер:

  • Привязка к номеру телефона или к верифицированному способу оплаты — один профиль на устройство и SIM.
  • Ограничение бонусов в день/месяц на одного реферера.
  • Триггер начисления — после реального целевого действия, а не за факт регистрации.
  • Чёрный список устройств и IP, которые подозрительно активны.
  • Отложенное начисление: бонус доступен через 24–72 часа, чтобы успеть отловить серийные регистрации.

Хорошая практика — логировать все события и регулярно вручную проверять топ рефереров: реальные адвокаты бренда отличаются от ботоводов в течение 2–3 минут просмотра.

Архитектура учёта

Минимальная схема в Postgres:

  • Таблица users: id, telegram-аналог chat_id, телефон, дата регистрации, реферер_id.
  • Таблица referral_events: id, реферер_id, приглашённый_id, тип события, статус, timestamp.
  • Таблица bonuses: id, user_id, тип, сумма, основание, статус (pending/accrued/cancelled).

При обработке /start с payload бот:

  1. Проверяет, что приглашённый — новый пользователь.
  2. Записывает связь в users.referer_id.
  3. Создаёт событие pending в referral_events.

После целевого действия event переводится в accrued, и бонус начисляется обоим. Если выявляется фрод — событие переводится в cancelled и бонус сторнируется.

Какие метрики смотреть

Реферальная программа оценивается по 5 ключевым числам:

  • K-фактор — среднее число приглашённых на одного активного пользователя. K ≥ 1 означает виральный рост.
  • Reach Rate — доля пользователей, кто хотя бы раз поделился ссылкой.
  • Conversion Rate приглашений — процент перешедших по ссылке, кто прошёл целевое действие.
  • CAC реферальных пользователей — стоимость привлечения через программу против платных каналов.
  • Retention приглашённых — через 30/60/90 дней. Реферальные обычно держатся лучше платных.

Дашборд в Metabase или собственный кабинет аналитики собирает эти числа из Postgres и обновляется ежедневно.

Частые ошибки

Что регулярно ломает программу:

  • Бонус слишком мал — пользователю не интересно делиться. Тестируйте размер на A/B.
  • Сложная механика — пользователь не понял, что получит. Объясняйте в одном экране.
  • Нет напоминаний — реферер забыл о ссылке. Push раз в 2 недели увеличивает активность.
  • Нет UTM-аналитики — невозможно понять, какие каналы работают.
  • Антифрод включают потом — потери за первый месяц могут сожрать бюджет программы.

Итого

Реферальная программа в боте MAX — это deeplink, учёт связей в Postgres, начисление бонусов после целевого действия и обязательный антифрод. Лучше всего работают двусторонние бонусы с лимитом в месяц. Ключевые метрики — K-фактор, конверсия и CAC; их видно в дашборде с первого дня. Технически программа собирается за 2 недели, дальше идёт калибровка размера бонусов.

Частые вопросы

Как технически устроена реферальная программа в боте MAX?

Из трёх частей. Уникальная ссылка для каждого пользователя — это deeplink на бота с параметром: реферер передаётся в команде /start. Bot API MAX, как и Telegram, прокидывает payload запуска в первый апдейт. Учёт перехода и регистрации приглашённого — бот сохраняет связь «новый пользователь → реферер» в PostgreSQL. Начисление бонуса обоим участникам после целевого действия (регистрация, первая покупка, оплата подписки). Минимальная схема в БД: таблицы users, referral_events, bonuses со статусами pending/accrued/cancelled.

Какие виды реферальных механик работают в боте?

Четыре основных. Двусторонний бонус: и реферер, и приглашённый получают подарок. Самая универсальная схема, выше виральность. Только пригласившему: бонус начисляется за каждого активного приглашённого, хорошо в B2C-сервисах. Многоуровневая программа: бонусы за приглашённых второго и третьего уровня, эффективна, но требует контроля антифрода. Турниры и таблицы лидеров: топ рефереров получает крупные призы, создаёт всплеск на короткий срок. Для большинства подходит двусторонний бонус с лимитом в месяц — простая, понятная и устойчивая к злоупотреблениям.

Как защитить реферальную программу от фрода?

Минимальный набор мер. Привязка к номеру телефона или верифицированному способу оплаты — один профиль на устройство и SIM. Ограничение бонусов в день/месяц на одного реферера. Триггер начисления — после реального целевого действия, а не за факт регистрации. Чёрный список устройств и IP, которые подозрительно активны. Отложенное начисление: бонус доступен через 24–72 часа, чтобы успеть отловить серийные регистрации. Хорошая практика — логировать все события и вручную проверять топ рефереров: реальные адвокаты бренда отличаются от ботоводов в течение 2–3 минут просмотра.

Какие метрики смотреть для реферальной программы?

Пять ключевых. K-фактор — среднее число приглашённых на одного активного пользователя. K ≥ 1 означает виральный рост (база растёт сама без вложений в рекламу). Reach Rate — доля пользователей, кто хотя бы раз поделился ссылкой. Conversion Rate приглашений — процент перешедших по ссылке, кто прошёл целевое действие. CAC реферальных пользователей — стоимость привлечения через программу против платных каналов (обычно в 2–4 раза ниже). Retention приглашённых через 30/60/90 дней — реферальные обычно держатся лучше платных.

Как deeplink в MAX передаёт реферальную метку?

Через параметр /start. Реферальная ссылка вида https://max.ru/bot?start=ref_USER_ID при переходе пользователя открывает бот и в первом апдейте передаёт payload «ref_USER_ID» в команду /start. Бот при обработке /start читает payload, определяет реферера, проверяет что приглашённый — новый пользователь, записывает связь в users.referer_id, создаёт событие pending в referral_events. После целевого действия event переводится в accrued, и бонус начисляется обоим. Если выявляется фрод — событие переводится в cancelled и бонус сторнируется автоматически.

Какие частые ошибки в реферальных программах для бота?

Пять типичных. Бонус слишком мал — пользователю не интересно делиться, тестируйте размер на A/B. Сложная механика — пользователь не понял, что получит, объясняйте в одном экране. Нет напоминаний — реферер забыл о ссылке, push раз в 2 недели увеличивает активность. Нет UTM-аналитики — невозможно понять, какие каналы работают (рассказал в чате, в сторис, лично). Антифрод включают потом — потери за первый месяц могут сожрать бюджет программы. Также критично использовать отложенное начисление, иначе фрод обнуляет бюджет за пару дней.