Данные реферального родителя
Тут собраны все функции для работы с данными Реферального Родителя
❖ Данные реферального Родителя
Функция "Данные Реф. Родителя" - дает возможность создателю бота, при помощи макросов в сообщении, показать рефералу данные из переменных его Реферального Родителя.
Функционал раздела «🧩Расширения»: чтобы "Данные Реф. Родителя" в вашем боте эта функция должна быть активированна в вашем боте.
Данные Реф. Родителя.
Для подключения перейдите в вашем боте:☞ 🔐Админ | 🧩Расширения | 📂Рефералка
Функция создана для тех кто спрашивал: "Как показать юзеру данные его Реф. Родителя для связи?". По этическим причинам мы не можем просто позволить вам публиковать личные данные реферального родителя без его разрешения. Вы бы сами не хотели чтобы случайные люди писали вам в личку десятками и сотнями, только потому что какой-то админ бота посчитал что разместить ссылку на ваш аккаунт в публичном пространстве это отличная идея. Для того чтобы всё-таки позволить рефералам каким-то образом связываться с их реферальными родителями мы и создали данную функцию. Однако создали мы её так чтобы каждый реферальный родитель мог сам определять позволять ли кому-то связываться с ним и если позволять то каким именно образом - через бот, группу или напрямую через личное сообщение. Причём для разрешения ему нужно будет совершить несколько осмысленных действий, лично указав способы связи. Такой подход видится нам наиболее ЭТИЧНЫМ и ЧЕСТНЫМ по отношению к людям которые будут использовать ваш бот.
Как это работает
Шаг 1:
Вы создаёте в Боте переменную которая будет содержать данные которые реферальный родитель САМ укажет как способ связи с ним.
Шаг 2:
Далее вы создаёте форму с функцией "Ввод Переменной" и просите пользователя вашего бота указать данные которые бы позволили его рефералам выйти с ним на связь. Это может быть ссылка на отдельную группа в которой он сможет собирать своих рефералов, либо созданный им для этих целей бот обратной связи (если ему необходим вариант более приватного общения) и, если это будет являться его выбором, то он сможет указать данные своего Телеграм аккаунта для личного обращения.
Как создать Форму "Ввода Переменной"
Шаг 3:
Для того чтобы показать рефералу данные указанные для него его реферальным родителем, Вы можете использовать специальный префикс:
Префикс: refparent_
Синтаксис: %refparent_varname% - макрос подставляет значение из любой переменной Реферального Родителя. Если Реф. Родителя нет или данные отсутствуют - оставляет пустое место.
Где:varname - это имя созданной вами переменной.
Например: переменная mylinks (в неё реф родитель добавил свои данные для связи), тогда макрос для показа рефералу будет выглядеть как: %refparent_mylinks%.
Значение других макросов (кроме имён переменных) не подставляется - по описанным выше причинам.
ВНИМАНИЕ: макрос потребляет 1 "Токен Функций" за каждую подстановку данных в сообщении при каждом показе.
❖ Сообщения об ошибках
---- вместо данных реферального родителя.
Данная ошибка будет показана при отсутствии "Токенов Функций" которые требуются для показа данных реферального родителя.
Как мы писали выше функция показа данных реферального родителя потребляет Токены Функции. В сообщении, которое показывается пользователю, мы не можем уточнять причину возникновения ошибки, поэтому просто обозначаем её возникновение.
❖ Макросы реферального родителя
Имя реферального родителя
Макрос %refparent_firstname% - покажет юзеру Имя (first name) его реферального Родителя.
ВНИМАНИЕ: макрос потребляет 1 "Токен Функций" за каждую подстановку данных в сообщении при каждом показе.
ВАЖНО: для использования этого Макроса выше указанная функция «Данные Реф. Родителя» - НЕ НУЖНА.
ЮзерКод реферального родителя
Для каждого уровня Реферального Родителя доступны макросы с его Юзеркодом. При использовании макрос покажет Юзеркод Реферального Родителя соответствующего уровня.
Макрос для уровня 1 выглядит так: %refparent_usercode1%.
Где:refparent_usercode - префикс1 - номер уровня
ВНИМАНИЕ: каждый макрос потребляет 5 "Токен Функций" УМНОЖЕННЫХ на текущий уровень - за каждую подстановку данных в сообщении, при каждом показе или использовании в Выражении, Функции или Action-е. Если на каком-то уровне Реферальный Родитель отсутствует - Токены больше не потребляются.
ВАЖНО: для использования этого Макроса выше указанная функция «Данные Реф. Родителя» - НЕ НУЖНА.
Уровень 1: %refparent_usercode1% - 5 Токенов Функций
Уровень 2: %refparent_usercode2% - 10 Токенов Функций
Уровень 3: %refparent_usercode3% - 15 Токенов Функций
и так далее...
Данный функционал является крайне требовательным к ресурсам сервера, потому как поиск данных Реферального Родителя для каждого уровня осуществляется с помощью полного просмотра Базы Данных - количество полных просмотров соответствует количеству уровней макроса.
Для первого уровня можно использовать макрос %refparent_usercode% - он НЕ потребляет Токенов.
Количество уровней Реферальных Родителей, макросы которых вы можете использовать - напрямую соответствует количеству уровней реферальной системы подключённой в вашем боте. Макросы не существующих уровней будут проигнорированы, если Реферальный Родитель на каком-то из уровней отсутствует то макрос покажет пустую строку.
❖ Дополнительная информация
Как использовать макросы Реферального Родителя?
Например в Action-ах.
● Action Транзакций (для начислений лучше использовать Action Рефералов)
● Action Сообщений - отправить сообщение отдельному Реферальному Родителю
Как создать многоуровневую реферальную систему?
Читай в руководстве по Рефералке.