Обработка параметров start (UTM)
Что такое параметр start?
Параметр start - это единственный способ передать данные в бот при его запуске. Чтобы его использовать нужно к обычной ссылке на бот добавить строку ?start={ ваши данные }, такие ссылки называются Deep links.
С его помощью вы можете сделать реферальную программу или добавить параметры для отслеживания источника пользователей. Подробнее про отслеживание можно прочитать в нашем блоге.
Как получить эти данные в боте?
Пример ссылки на бот: https://t.me/Graspil_bot?start=docs
Значение, которое получит бот docs
Когда пользователь запускает бот, вам приходит Update типа
Message. В нем есть параметр text который равен /start, в случае с deep link параметр text будет равен /start docs
Пример
{
update_id":10000,
"message":{
"date":1441645532,
"chat":{
"last_name":"Test Lastname",
"id":1111111,
"first_name":"Test",
"username":"Test"
},
"message_id":1365,
"from":{
"last_name":"Test Lastname",
"id":1111111,
"first_name":"Test",
"username":"Test"
},
"text":"/start docs" // <----- данные переданные в start
}
}Существует ограничение в 64 символа на длину строки в параметре start
Как graspil обрабатывает параметр start?
Graspil использует этот параметр для отслеживания источника пользователей. Телеграм не поддерживает дополнительных параметров, поэтому мы добавили возможность настроить логику обработки данного параметра.
Так как в start можно передать только одну строку, мы добавили правила с помощью которых такую строку можно разделить на разные параметры.
Например, вам нужно передать источник перехода по ссылке и тип источника (например email). Для этого вы можете использовать строку такого вида start=source-news1_medium-email и задать нужные настройки для ее обработки.
В graspil все такие параметры преобразовываются в параметр=значение иными словами в таблицу, с которыми в дальнейшем можно работать (строить отчеты, фильтровать данные).
source
news1
medium
О том как настроить обработку параметра start вы можете прочитать в следующем разделе
Последнее обновление