Technical Requirements #

To successfully integrate Monetag ad formats into your Telegram Mini App, your project must meet several technical conditions. These ensure stable ad delivery, compatibility with Telegram’s web environment, and optimal user experience.

Telegram Mini App Basics #

Before implementing ads, make sure your app is fully functional as a Telegram Mini App. This includes:

• Your app must be a web-based service (HTML/JS/CSS) accessible via HTTPS.
• It should be launched via a Telegram bot using the Web App API.
• The app must be mobile-optimized, responsive, and tested within Telegram’s WebView.

Ad Placement Requirements #

• JavaScript Support: Ads are served through JavaScript tags and require full JS support inside your Mini App.
• DOM Access: Monetag SDK needs access to the browser’s DOM to inject and display ad elements.
• No aggressive refreshes: Avoid reloading the Mini App or dynamically replacing the entire DOM, as this may interrupt ad delivery or tracking.

Mobile-First Design #

Telegram users typically interact with Mini Apps via smartphones. It’s important that your layout, text sizes, and user flow are tailored for small screens. The Monetag SDK is optimized for mobile and performs best in such environments.

Testing and Debugging #

We strongly recommend testing your app in the actual Telegram environment on both iOS and Android. Be sure to:

• Use test zones (provided by Monetag) for safe ad loading during development.
• Check performance across different Telegram app versions and devices.
• Verify compatibility with both light and dark themes.

Security and Policies #

• All external resources (scripts, styles, images) must be loaded over HTTPS.
• Your Mini App must comply with Telegram’s Bot Platform Terms and Monetag’s publisher policies.
• No misleading or harmful behavior is allowed, such as forced clicks or auto-redirects.

If your app violates these conditions, ad delivery may be blocked or restricted.