Как настроить партнерскую программу с помощью модуля «Воронки»

С помощью модуля «Воронки» можно решить множество задач в вашем проекте. Одна из них — это организация партнерской программы, в которой партнеры могут приглашать рефералов и получать вознаграждение.

В этой статье разберем, какие настройки понадобятся для запуска партнерской программы через модуль «Воронки». О том, как настроить партнерку через стандартный функционал, читайте в статье «Как запустить партнерскую программу на GetCourse».

Используя модуль «Воронки» вы можете реализовать разнообразные схемы партнерской программы. В статье мы рассмотрим простую схему, которая состоит из следующих действий участников:

1. Партнер запускает бота, отправляет в него заданную вами команду и получает свою партнерскую ссылку для подключения к боту. После чего распространяет свою ссылку любыми доступными средствами.
2. Пользователь запускает бота по полученной партнерской ссылке и становится рефералом.
3. Партнеру приходит уведомление о том, что у него появился новый реферал, а также ему начисляются бонусные рубли в аккаунте школы.

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

Чтобы настроить партнерскую программу по схеме выше, подключите к аккаунту бота и добавьте его в сцену:

• Как подключить и использовать Telegram в модуле «Воронки»
• Как подключить и использовать VK-сообщество в модуле «Воронки»

Чтобы партнер или реферал могли пройти по этой воронке, сперва им потребуется запустить бота и зарегистрироваться, предоставив свой email.

Для настройки запуска:

1. Добавьте в воронку ноду «Команда бота» и оставьте в ней команду /start.

2. Перейдите в шапке воронки на вкладку «Запуск».
3. Нажмите на значок над нодой «Команда бота», чтобы указать настройки при запуске блока.
4. Включите опцию «Установить переменные» и добавьте выражение chat.partner = event.utm?.startParam || null. Оно поможет связать запуск с партнером, по чьей ссылке перешел реферал.
5. Нажмите «Применить».

2. Добавьту ноду «Ввод пользователя». Данная ветка будет использоваться для случая, когда пользователь ввел не email, а что-то другое.
3. В настройках выберите вариант «содержит любой ввод, который не был перехвачен соседними блоками» и выключите опцию «Сохранить ввод пользователя».
4. Нажмите «Применить».

5. Добавьте ноду «Отправить сообщение», в которой можно уведомить пользователя о том, что он так и не отправил email, и попросить направить его вновь.

6. Добавьте ещё одну ноду «Ввод пользователя». Она будет использоваться для ветки, когда пользователь отправил email в бота.
7. В настройках ноды выберите вариант «соответствует регулярному выражению» и добавьте выражение ^[\w-\.]+@([\w-]+\.)+[\w-]{2,4}$. Оно проверяет, соответствует ли введенное пользователем сообщение формату email.
8. Замените переменную chat.lastMessage на chat.email, чтобы на следующем этапе использовать эл. адрес пользователя для регистрации.
9. Нажмите «Применить».

10. Добавьте ноду «Зарегистрировать пользователя GetCourse» и укажите в ней переменную chat.email, чтобы пользователь добавился в базу с присланным email.

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

Для этого:

1. Добавьте в воронку ноду «Команда бота».
2. Выберите в ней вариант запуска «точно совпадает с любым из вариантов».
3. Добавьте команду, с помощью которой партнер сможет получить свою партнерскую ссылку, например, /partner.
4. Нажмите «Применить».

Вариант 1 — Пользователь запустил бота по партнерской ссылке и стал рефералом. Чтобы отслеживать выполнение данного события:

1. Кликните два раза на стрелку и нажмите на «Установить условие».

2. Выберите вариант запуска «все условия выполнены»
3. Укажите значения переменных chat.partner и chat.partner != chat.id, чтобы проверить, что запуск бота был именно по партнерской ссылке, но не партнером, которому принадлежит ссылка.
4. Нажмите «Применить».

Вариант 2 — Пользователь запустил бота не по партнерской ссылке. Чтобы отслеживать выполнение данного события:

1. Кликните два раза на стрелку и нажмите на «Установить условие».

2. Выберите вариант запуска «ни одно из условий не выполнено»
3. Укажите значения переменных НЕ chat.partner, чтобы проверить, что в ссылке для запуска бота не было партнерского кода.
4. Нажмите «Применить».

Вариант 3 — Партнер запустил бота по своей же партнерской ссылке. Чтобы отслеживать выполнение данного события:

1. Кликните два раза на стрелку и нажмите на «Установить условие».

2. Выберите вариант запуска «все условия выполнены»
3. Укажите значения переменных chat.partner и chat.partner == chat.id, чтобы проверить, что в ссылке есть партнерский код и он принадлежит тому же партнеру, который запустил бота по этой ссылке.
4. Нажмите «Применить».

Чтобы после того как реферал запустит бота по партнерской ссылке, срабатывали последующие реакции для партнера, необходимо передать данные о реферале в ноду «Событие». Для этого используйте ноду «Вызвать URL».

Для настройки передачи:

1. Откройте ноду «Событие» и перейдите на вкладку «Внешний вызов».
2. Включите опцию «Разрешить вызов внешней системой».
3. Скопируйте ссылку для внешнего вызова.
4. Примените настройки.

5. Нажмите на значок над нодой «Событие», чтобы указать настройки при запуске блока.
6. Включите опцию «Установить переменные» и добавьте выражение chat.lastReferalName = event.params.referalName. Оно потребуется для того, чтобы в дальнейшем отправить партнеру имя нового реферала.
7. Нажмите «Применить».

9. Откройте ноду «Вызвать URL» и вставьте скопированную ссылку.
10. Выберите тип запроса POST и тип ответа json.
11. В тело запроса добавьте следующий код, чтобы передать данные о реферале для последующих событий.

{
    chatId: chat.partner,
    customData: {
    referalName: chat.userName,
  }
}

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

Для этого:

1. Добавьте ноду «Прокси» и соедините её с нодой «Команда бота» для партнера.
2. Нажмите два раза на стрелку и включите опцию «Ограничить кол-во запусков».
3. Примените настройки.

4. Зайдите в настройки запуска ноды «Прокси» и включите опцию «Установить переменные».
5. Добавьте переменную chat.hasReferals = 0. С её помощью будет начинаться подсчет рефералов партнера.
6. Нажмите «Применить».

7. Добавьте еще одну ноду «Прокси» от ноды «Событие».
8. Зайдите в настройки запуска ноды и включите опцию «Установить переменные».
9. Добавьте переменную chat.hasReferals += 1, чтобы при появлении нового реферала у партнера количество текущих увеличивалось на 1.
10. Нажмите «Применить».

2. В настройках запуска ноды с отправкой сообщения рефералу (ветка не от партнера) добавьте переменную chat.userId = user.id

3. Добавьте отдельное событие для партнера и скопируйте его идентификатор. 

4. В ветке партнера после отправки сообщения о новом реферале добавьте ноду «Создать событие».
5. Вставьте идентификатор из ноды «Событие».
6. Выберите метод вычисления «По выражению».
7. Добавьте 2 агента:
   • Пользователь с переменной chat.userId,
   • Чат с переменной chat.id.
8. Нажмите «Применить».

9. Добавьте ноду «Начислить/Списать баланс» после ноды «Событие» и укажите, какое количество бонусных рублей будет начислено партнеру.

Готово! Остается запустить воронку, и партнерская программа настроена.