К основному содержимому

Интеграция мини-приложения Telegram

Автор: Natalya Yefimenko
Обновлено сегодня

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

Affise MMP TMA

Ваше мини-приложение интегрируется с Affise MMP за три простых шага:

  1. Добавьте свое приложение в свой профиль Affise MMP.

  2. Интегрируйте Affise MMP SDK для мини-приложения (TMA).

  3. Протестируйте отслеживание событий и получите реальный трафик.


Добавление нового приложения Telegram

Чтобы добавить мини-приложение Telegram, выполните следующие действия:

  1. Перейдите в раздел Приложения > Добавить новое приложение > Telegram.

  2. В появившемся окне заполните поля:

    Affise MMP 2024-08-27 at 7.12.57 PM

    1. Ссылка Telegram: вставьте ссылку на ваше приложение.

    2. Название пакета / ID: введите название пакета вашего приложения. Это конечная часть вашей ссылки.

    3. Логотип: загрузите логотип приложения.

    4. Название в Telegram: добавьте официальное название вашего мини-приложения в Telegram.

    5. Необязательно. Описание: напишите описание вашего приложения, чтобы привлечь больше издателей.

    6. Часовой пояс: выберите часовой пояс для отображения ваших отчетов.

    7. Валюта: выберите валюту, в которой будут начисляться выплаты за события.

  3. Нажмите Добавить новое приложение, чтобы сохранить ваше мини-приложение.

🔎 Подробнее о добавлении приложений читайте здесь.

Редактирование приложения Telegram

В разделе Приложения вы можете увидеть свое мини-приложение Telegram в списке приложений.

Нажмите Просмотр / Редактировать в меню Действия, чтобы настроить приложение:

Screen Recording 2024-08-27 at 08.20.01 PM

  • Общие: проверьте общую информацию о приложении и получите токен приложения для инициализации SDK.

  • Настройки: вы можете настроить постбэки для отправки событий из вашего приложения в другие трекеры.

  • Партнеры: вы можете увидеть партнеров, подключенных к вашему приложению, и их ссылки для отслеживания.

  • Атрибуция Facebook: вы можете настроить интеграцию с Facebook для получения трафика из этого источника.

  • Google Ads: вы можете настроить интеграцию с Google Ads для получения трафика из этого источника.

  • Интеграции: вы можете получить токен приглашения и поделиться им с партнерами, чтобы они могли направлять трафик в ваше приложение.

🔎 Подробнее о настройках приложения читайте здесь.

Интеграция Affise MMP SDK для TMA

Чтобы интегрировать Affise MMP SDK — https://github.com/affise/sdk-telegram-mini-app — в ваше мини-приложение, сначала вам понадобится токен для инициализации SDK.

  • После добавления приложения ему назначается токен, необходимый для инициализации SDK.

GitHub - affisesdk-telegram-mini-app JS SDK for Telegram Mini App 2024-08-27 at 7.26.46 PM

  • Чтобы получить токен, перейдите в раздел Приложения > ваше приложение Telegram > Общие.

  • Скопируйте значение из поля Token.

    Affise MMP 2024-08-27 at 7.50.56 PM

  • Затем определите и настройте события, которые необходимо отслеживать — https://github.com/affise/sdk-telegram-mini-app?tab=readme-ov-file#for-events-registration — и протестируйте их.

Настройка трекинга мини-приложения

После интеграции мини-приложения Telegram вы можете получить трекинговую ссылку, поделиться ею с партнером и начать привлекать трафик.

​В качестве альтернативы вы можете использовать реферальные ссылки Telegram формата t.me/:

  1. Добавьте партнера в свой аккаунт.

  2. Используйте соответствующий pid в ссылке t.me. Пример

    ссылки:
    https://t.me/virus_play_bot?start=abc&pid=20
    или
    https://t.me/virus_play_bot?start=20

  3. Запустите ссылку отслеживания Affise MMP с параметром pid внутри SDK в формате json перед отправкой постбэка/события для регистрации клика в Affise MMP. Пример

    ссылки:
    https://trk.affattr.com/6T2B00TTFRXNV?clickid={clickid}&pid=20&format=json

🔍 Редирект таким образом не происходит, но клик регистрируется в Affise MMP.

4. Отправляйте события с тем же PID в Affise MMP.


По всем возникшим вопросам обращайтесь в службу поддержки Affise по электронной почте: [email protected].

Нашли ответ на свой вопрос?