Не показывается реклама в Telegram Mini App: что проверить
Если в Telegram Mini App не показывается реклама, сначала отделите ошибку интеграции от no fill — отсутствия подходящего объявления. При незагруженном SDK показ не начнётся, а у исправной интеграции реклама может быть доступна не для каждого запроса. GigaPub — рекламная сеть и платформа медиации рекламы для Telegram Mini Apps. Разберём, как найти проблемный шаг и сохранить работающий интерфейс, пока вы выясняете причину.
Коротко
- Проверяйте всю цепочку: загрузка SDK, вызов показа, результат запроса и состояние интерфейса после ошибки.
- Отклонённый промис сообщает о сбое, но сам по себе не доказывает no fill.
- Сравнивайте устройства, страны и подключения, прежде чем менять интеграцию.
- Обрабатывайте ошибки без бесконечных повторов, параллельных запросов и навсегда заблокированной кнопки.
С чего начать, если реклама не появляется?
Воспроизведите одну попытку внутри Telegram. Зафиксируйте, какую кнопку нажали, появился ли индикатор загрузки и восстановилось ли приложение после ожидания. Затем найдите в консоли и сетевых запросах события именно этой попытки.
Таблица поможет выбрать следующую проверку:
| Симптом | Возможная причина | Что проверить |
|---|---|---|
| Функция показа отсутствует | SDK не загрузился, заблокирован или вызван слишком рано | Запрос скрипта и порядок выполнения |
| Нажатие ничего не меняет | Не подключён обработчик или раньше возникла ошибка JavaScript | Обработчик кнопки и первая ошибка в консоли |
| Запрос есть, объявления нет | Нет подходящей рекламы, произошёл тайм-аут или сбой провайдера | Сообщение об ошибке без секретов и время запроса |
| Ошибка только у части пользователей | Страна, устройство, клиент Telegram или подключение | Сопоставимые сегменты аудитории |
| Загрузка не заканчивается | Не сбрасывается состояние после ошибки или запросы накладываются | Восстановление кнопки при любом результате |
Это направления диагностики. Например, тайм-аут сам по себе не означает, что у сети закончилась реклама.
Как проверить, что SDK GigaPub загрузился?
Сверьте адрес скрипта и ID своего проекта с действующей инструкцией GigaPub. Документированный адрес — https://ad.gigapub.tech/script?id=YOUR_PROJECT_ID, функция показа — window.showGiga().
Во вкладке Network проверьте успешную загрузку скрипта. В консоли выполните typeof window.showGiga после загрузки: до вызова рекламы результат должен быть "function". Иначе ищите неуспешный запрос, ограничения Content Security Policy, ошибку исполнения или слишком ранний вызов.
Если приложение использует Nuxt или другой серверный рендеринг, обращайтесь к браузерному API на клиенте после готовности SDK. Асинхронная загрузка тега и немедленный вызов функции могут создать гонку. Также убедитесь, что повторное открытие экрана не добавляет ещё один обработчик на ту же кнопку.
В официальной инструкции есть загрузчик с резервным доменом для проблем доступности. Берите актуальный пример из документации. Базовая последовательность подключения разобрана в статье об интеграции SDK GigaPub.
Чем no fill отличается от ошибки интеграции?
No fill означает, что рекламный запрос не получил подходящее объявление. Сам запрос может быть корректным, но доступный спрос не подходит пользователю, стране, формату или моменту показа. На доступность также могут влиять ограничения провайдера и лимиты частоты.
Ошибка интеграции возникает на другом шаге: скрипт не загрузился, функция недоступна, запрос сформирован неверно или результат не удалось отобразить. Разделяйте эти причины в своих логах. Если SDK не передал документированную причину отказа, сохраняйте его как неклассифицированную ошибку, а не записывайте любое отклонение промиса в no fill.
Для собственной воронки определите, что считается попыткой: например, одно принятое приложением нажатие пользователя. Отдельно считайте попытки, состоявшиеся показы и ошибки. Повторные нажатия во время уже начавшейся загрузки не должны становиться новыми рекламными возможностями.
Кабинет GigaPub показывает метрики показов и дохода, а журнал попыток в вашем приложении помогает понять, что случилось до показа. Разницу между доступностью рекламы и заработком за показ объясняет статья про eCPM, fill rate и ARPDAU.
Почему на одном устройстве реклама работает, а на другом — нет?
Telegram Mini Apps запускаются в разных клиентских окружениях. Успешная проверка в браузере на компьютере не подтверждает работу того же сценария внутри Telegram на Android или iOS. Воспроизводите проблему на затронутой платформе с тем же способом входа и сопоставимым подключением.
В документации Telegram описаны инструменты инспекции WebView для поддерживаемых клиентов. Они помогают увидеть причину сбоя на самом устройстве, а не только скриншот бесконечной загрузки.
Меняйте по одному условию: версию Telegram, операционную систему, страну или подключение. При блокировке запроса изучайте сообщение об ошибке и политику безопасности приложения. Если запросы проходят, а доступность отличается по странам, проверяйте спрос и таргетинг. Не каждое региональное различие связано с дефектом кода.
Как вести себя приложению при неудачном показе?
Покажите понятный результат и верните управление пользователю. Для rewarded-рекламы сообщите, что объявление сейчас недоступно. В обработчике ошибки нельзя считать просмотр завершённым и выдавать награду за просмотр. Если продукт отдельно предлагает утешительный бонус, у него должны быть собственные правила.
Разрешайте только одну попытку показа одновременно. Сбрасывайте индикатор загрузки и состояние кнопки и после успеха, и после отказа. Бесконечный цикл немедленных запросов ухудшает интерфейс, но не создаёт рекламный спрос.
Перед новой попыткой предусмотрите паузу. В статье о частоте рекламы и удержании объясняем, как согласовать лимиты между рекламными местами. Другой вариант монетизации, например офферволл, предлагайте с понятным описанием задания и награды. У него свои условия доступности, а результат нужно обрабатывать отдельно.
Помогает ли медиация уменьшить no fill?
Медиация рекламы может снизить зависимость от одного источника, обращаясь к другим подходящим источникам спроса. Она не создаёт рекламодателя для каждого пользователя и не гарантирует 100% заполнения. Сбои сетей, недостаток спроса и ограничения клиента по-прежнему возможны.
О роли нескольких источников читайте в статье об устройстве медиации. Результат оценивайте на своём трафике с одинаковыми определениями метрик, учитывая время ожидания и удержание. Дополнительные запросы полезны, когда улучшают пользовательский опыт и экономику приложения.
Если причина не найдена, обратитесь в поддержку GigaPub. Подготовьте ID проекта, время и часовой пояс, страну, устройство, версию Telegram и шаги воспроизведения. Из сообщений об ошибке удалите токены, исходные данные авторизации и другие секреты.
Какие вопросы о неработающей рекламе задают чаще всего?
Почему не показывается реклама в Telegram Mini App?
Проверьте загрузку SDK, правильность ID проекта, выполнение вызова показа и зависимость ошибки от устройства или подключения. Корректный запрос тоже может закончиться no fill, если подходящей рекламы сейчас нет.
Что означает no fill?
No fill означает, что рекламный запрос не получил подходящее объявление. Это отличается от ошибки загрузки SDK или JavaScript. Само по себе отклонение промиса не позволяет определить причину.
Гарантирует ли медиация 100% заполнения?
Нет. Медиация может обратиться к нескольким источникам спроса и снизить зависимость от одной сети, но доступность рекламы зависит от спроса, таргетинга, поддержки платформы и качества подключения.
Нужно ли сразу повторять запрос после ошибки?
Не запускайте бесконечные автоматические повторы. Восстановите интерфейс, покажите короткое сообщение о недоступности рекламы и разрешите новую попытку после паузы. Приложение должно оставаться доступным без показа.
Что передать в поддержку GigaPub?
Передайте ID проекта, время и часовой пояс, страну, устройство, версию Telegram, шаги воспроизведения и очищенные от секретов сведения об ошибке. Не отправляйте токены бота, приватные ключи и исходные данные авторизации.
Создайте аккаунт паблишера GigaPub и подключите приложение по официальной инструкции.