Подключение Mini App
Last updated
Last updated
Чтобы подключить Mini App, нужно добавить его на соответствующей странице ().
Система попросит вас выбрать бота к которому принадлежит Mini App и его системное название.
Системное имя нужно для сопастовления данных которые приходят в сам бот, если вы укажите не верное имя то при обнаружении таких данных система создаст Mini App с найденым именем, это приведет к путанице в данные.
Добавив Mini App в graspil, вы получите key и код который нужно добавить в ваш Mini App
Замените <--ВАШ КОД--> в 5 строке на key который вы получили
Этот код нужно добавить в секцию <head> вашего приложения.
Чтобы аналитика корректно работала в таких приложениях требуется дополнительно произвести следующие манипуляции:
В качестве значений для полей event и category используйте название события (т.е. например mainButtonClicked и т.д.)
По умолчанию система собирает события кликов по кнопкам и ссылкам, а так же все события формируемые Telegram.
При кликах в качестве названий событий используется содержимое кнопок и ссылок. Вы можете передавать свои события добавив к HTML элементам атрибут data-gs-event
Пример:
Вы можете передавать свои события, вызвав код
event
string
да
Название событие
category
string
нет
Название категории
value_num
float
нет
Числовое значение, например цена (число с плавающей запятой).
unit
string(3)
да, если есть value
Метки добавляются аналогично меткам в боте, за одним исключением вместо start нужно использовать параметр startapp
Пример: https://t.me/graspil_bot/app?startapp=source-doc
По умолчанию graspil умеет определять откуда был запуск Mini App из публичного канала/чата или из вашего бота. Но помимо этого у вас есть возможность настроить трекинг запусков с конкретной кнопки.
Например, ваш бот предоставляет пользователю 3 кнопки для запуска Mini App:
Кнопка меню (стандартная кнопка рядом с полем ввода)
Кнопка "Open App" на странице бота (там где описание бота и юзернейм)
И скорей всего вы отправляете стартовое сообщение пользователю с кнопкой запуска App
У каждой такой кнопки вы задаете https адрес вашего приложение например: https://example.com/myapp если к этому адресу вы добавите параметр gs_source=my_button то это значение будет использовано как источник сессии в Mini App и вы сможете увидеть эти данные в соответствующих отчетах.
В качестве примеров возьмем кнопки перечисленные выше, добавим параметр gs_source к каждой ссылке:
Кнопка меню - https://example.com/myapp?gs_source=menu_button
Кнопка "Open App" - https://example.com/myapp?gs_source=main_button
Кнопка в стартовом сообщении - https://example.com/myapp?gs_source=start_msg
Вы можете использовать параметр gs_source везде, где используется прямая ссылка на App, в остальных случаях используйте UTM метки.
Некоторые библиотеки для Telegram Mini App удаляют или очищают глобальный объект window.Telegram (например библиотека ).
При запуске пользователе Mini App ваше приложение должно передать объект и дополнительные параметры
Пример того как получить эти данные в доступен по ссылке
Автоматический трекинг (таких, как mainButtonClicked, backButtonClicked и т.д) в Mini App в этом случае работать не будет.
Если вы хотите передавать такие события вам придется передавать их вручную, используя код для .
Код валюты, максимальная длинна строки 3. Аналогично
Трекинг UTM работает в общей системе graspil, аналогично . Это означает если пользователя был определен в боте он будет сохранен (в рамках ) за пользователем запустившим Mini App и наоборот.
Метки обрабатываются в соответствии с правилами заданными боту,