TMA

Как настроить обмен трафиком в TMA (Telegram Mini Apps)

Вы наверняка уже установили и инициализировали SDK, а так же отправили событие ready.

Теперь в разделе заданий (или еще где-либо на ваше усмотрение) необходимо реализовать следующий механизм:

1. Получить список заданий, используя метод SDK feed

2. В нужный момент (или сразу после получения) — показать задания пользователю

3. В момент показа отправить событие impressions

4. При клике по заданию, используя встроенный в SDK метод open, отправить пользователя на рекламируемый ресурс.

5. Метод open запускает интервальную проверку и возвращает Promise, который резолвится в случае успешного обмена, и реджектится по таймауту через 100 сек., в случае, если пользователь после клика так и не запустил (или не дождался) рекламируемый ресурс.

6. В случае успеха (resolve) нужно наградить пользователя (если это предусмотрено) и скрыть соответствующее задание.

7. В случае неудачи (reject) можно отобразить сообщение об ошибке, например "Что-то пошло не так, попробуйте еще раз"

ВАЖНО!!! Если ваш флоу подразумевает получение заданий с моментальным их отображением, вы можете использовать параметр autoImpressions: true в методе feed, таким образом вам не нужно отдельно отправлять событие impressions. В противном случае, если вы делаете предварительную загрузку заданий и показываете их позже, параметр autoImpressions передавать не нужно, а метод impressions нужно обязательно вызвать в момент показа.

Описание всех методов и примеры смотрите в разделе Web SDK.

Если по каким-либо причинам вы не можете использовать Web SDK, вы можете реализовать все то же самое поверх API.