August 30, 2023

Story telling PDL TG BOT Mechanic

Первичное описание задачи, находится тут.

Админка для управления:

  1. Контентом
  2. Ботами
  3. Юзерами
  4. Саппорт переписка
  5. Пушами

Статистика

  1. Ботов
  2. Юзеров
  3. Флоу статистика Events (анализ продуктовых метрик)
  4. Пушей

Модули в механике:

  1. Основная воронка, выдача ТОП предложений и т.д.
  2. Опрос со сбором данных
    1. API рассылка данных
  3. Саппорт запрос


Глоссарий и определения

Механика - это функционал бота, который предоставлен юзеру для взаимодействия в телеграмм, после подписки (активации start) бота.

Внутри механики может быть множество ботов.

Бот - это созданный username_bot через функционал телеграмма BotFather.

Бот в нашей деятельности используется как расходный материал, аккаунт, характеризующий кол-во потенциальных точек входа юзера для взаимодейтсвия с механикой.

Бот принадлежит к одной механике.

Если нужно использовать новую механику, то для этого нужно изменить механику осуществив ручной или автоматический перенос.

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

Пуш - принудительно отправленое сообщение пользователю в бота.

Пуш может быть отправлен 1 механику = множество ботов = множество юзеров.

Отправка пуша будет описана отдельно в админ.панеле по отправке пушей, но суть такова, что отправка пуша может осуществляться по расширенным настройкам и по schedule (шедулеру).

Исходящий клик - нажатие пользователем ссылки, которая открывается в браузере. Иными словами пользователь покидает бот и попадает в браузер (ин-ап браузер, Гугл хром, сафари и т.д.)

Placeholder (плейсхолдер) - “макрос”, “токен”, “utm метка” которая хранится в таблицах БД по юзеру и подставляется к каждому исходящему клику, по запросу.

PDL - Pay Day Loan, микрозаймы, кредитование.

ТГ - сокращенно от Телеграмм.


Взаимосвязи

1 механика = множество ботов.

1 пользователь = множество ботов.

1 пуш = 1 механика = множество ботов (по выбору)

Связь между таблицами происходит через Многие ко Многим.

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

Каждый бот для пользователя это отдельный бот. Кроссботовости для юзера нет (т.е. Если что-то сделал в одном боте, то это никак не влияет на то, что он выбрал в другом боте).


Общий Алгоритм работы от создания до пуша.

  1. Создается бот. Получаем токен бота.
  2. Загружаем по API токен бота в БД, для активации механики на боте.
  3. Пользователь активирует бота. Нажимает Start.
  4. Происходит запись в БД по юзеру, его источнику из диплинки и сопутствующей информации при регистрации в боте.
  5. Взаимодействует с ботом.
  6. Бот подключается к общей БД и выдает пользователю нужный контент, исходя из нажатия кнопок в меню, согласно флоу механики.
  7. При исходящем клике динамически подставляются нужные плейсхолдеры к ссылке в виде UTM меток к основному URL. Далее клик следует через TDS (“Traffic Distribution System”) где по плейсхолдерам происходит перераспределение на конечный путь.
  8. Обращение пользователя в поддержку. Происходит заполнение in-app web form с дальнейшей передачей в нашу таблицу запросов. Если пользователь вводит контактные данные, которых у нас нет в БД, то нам нужно будет их добавить в соответствующий столбец.
  9. Администратор может ответить на запрос, может сортировать их, фильтровать, экспортировать и т.д.
  10. Рекламный пуш. Принудительная рассылка сообщений пользователю в бота. Генерирует сообщение, кнопка, контент (видео, гиф, картинка), выбираются теги по которым отправить, выбирается дата отправки (шедулер), проставляются исходящие URL ссылки с нужными плейсхолдерами (те что. Нас есть в БД). Далее пользователь получает пуш, мы видим статистику (отправлено, получено, открыто), понимаем сколько после рассылки у нас не открытых и удаленных пользователей.


Краткое описание модулей механики

1. Основная воронка, выдача ТОП предложений и т.д.

Основной целью является вовлечь пользователя предложением и увести его на внешний ресурс, через исходящий клик с плейсхолдерами.

Тут главное это работа с конвентом, правильная выдача контента (ссылок, картинок, текстов).

Здесь идет работа с таблицей контента и плейсхолждеров.

2. Опрос со сбором данных

Основной целью является собрать как можно больше информации о юзере записать ее в БД и далее отправить рекламодателю.

Отправка будет производиться через API между нашей БД и рекламодателем.

Тут ключевым будет опросить пользователя и записать всю информацию в БД.

Далее уже будет отдельный модель по API отправке эти данных.

3. Саппорт запрос

Основной целью является получить запрос на помощь от юзера, записать обращение, обработать его (проигнорировать или ответить).

Тут нужно сделать свою форму которая будет открываться в ТГ боте, юзер заполнит поля, которые затем нам нужно передать и записать в БД.