Add your Monetag zone, screen by screen
0 / 15 done-
Open My Bots on the home screen
Mini Empire opens on a grid of six tiles. Monetization lives inside a bot, so the first tile is where this starts: My Bots.
Where: Mini Empire → My Bots9:41Mini EmpireCreate, launch and manage all your bots and apps in one place0My apps · 0 active0Total users0.00GRAM deposited0Global tasksMy Bots My TON Global Broadcast Global Tasks Promote AffiliatesAcademyLearn to grow your empireSix tiles. My Bots is the first one.
-
Choose Mini Apps, not Chat Bots
My Bots opens as a folder over the home screen with two options. Mini Apps is the one that serves ads, because the ad SDK runs inside the web app. Chat Bots live entirely in the chat and have no page to show an ad on.
Where: My Bots → Mini Apps9:41My BotsMini Apps Chat BotsThe folder floats over the home screen. Tapping outside closes it.
-
Tap New Mini App
The list is empty the first time, with a single button at the top. Every mini app you create later appears here as a card.
Where: Mini Apps → + New Mini App9:41‹Mini AppsCreate and manage your Telegram mining mini apps. Your bot, your wallet, your economy.
+ New Mini AppNo mini apps yet.
The create button sits above the list.
-
Paste the bot token from @BotFather
Open @BotFather in Telegram, send /newbot, and it replies with a token that looks like 123456789:AAF… Paste it here. Mini Empire calls Telegram with that token and shows you the bot it belongs to — photo, name and @username — so a token pasted into the wrong project is caught before anything is created.
Where: Wizard → step 1A bot token controls the bot completely. Never paste it into a chat, a screenshot or a support ticket.
9:41BOT TOKEN
Next123456789:AAF... -
Add the API key and the wallet, then create
Step 2 asks for a free API key from toncenter.com, which is how the bot reads the blockchain. Step 3 asks for the 24 words of a wallet. Use a wallet created only for this bot: user deposits arrive there and withdrawals are paid from it. Accept the terms and tap Create.
Where: Wizard → steps 2 and 3Whoever holds those 24 words holds the bot’s funds. Write them down offline and never reuse a personal wallet.
9:41WALLET MNEMONIC
word1 word2 word3 ...Use a DEDICATED wallet created only for this bot. Never your personal wallet.
Validate & Create -
Open the admin panel
When the bot is created the screen confirms it is live and offers Open admin panel. This is the dashboard for this one mini app, and the header shows its photo and name so you always know which project you are editing.
Where: Mini app created → Open admin panel9:41Mini app created!
Your bot is live: @gold_rush_bot
Open admin panelShown once, right after the wizard finishes.
-
Tap the Monetization tile
The panel is a grid of eight tiles. Monetization is the fourth, the one with the megaphone. Everything about ads for this mini app lives behind it.
Where: Admin panel → Monetization9:41FREE Gold RushAdmin PanelEconomy Withdrawals Statistics Monetization Users Tasks Appearance Wallet🌐 English⌄Eight tiles. Monetization is the one with the megaphone.
-
Unlock monetization for this project
This is the screen most people get stuck on. A free project runs Mini Empire branding and Mini Empire ads, and that is what pays for the free tier — so the network fields do not exist yet. Instead you get this. The unlock is a one-time payment in GRAM for this project: it removes the platform branding and hands the ad revenue to you.
Where: Monetization → Unlock MonetizationUntil this is unlocked, the Monetag field does not exist. If you have "done everything" and cannot find where to paste your zone, this is why.
9:41Keep 100% of your revenue
Connect your own ad networks and take full control of monetization.
✓100% of ad revenue goes to you✓Connect your own ad networks (Adsgram, Monetag, Gigapub, Richads)✓Remove Mini Empire ads & branding✓Run ads from multiple networks at once — or turn them all off completely✓Lifetime access with one payment$69$99One-time payment • Paid in GRAMUnlock MonetizationMaybe laterA free project sees this instead of the network grid.
-
Pay the invoice in GRAM
Tapping Unlock shows an address and a memo. Send the exact amount with that memo attached — the memo is how the payment is matched to your project, so a transfer without it does not apply. The panel watches for it and unlocks by itself once the transfer lands; there is nothing to send us and no receipt to forward.
Where: Unlock → Complete paymentSend the memo exactly as shown. A payment without the memo is not matched automatically.
9:41Complete payment
Send exactly this amount in GRAM. It is applied automatically once received.
✓Address — tap to copy✓Memo (required) — tap to copyPay with TonkeeperCancel— GRAMThe memo is required. Without it the payment cannot be matched.
-
Now the network grid appears
With the project unlocked, Monetization shows what it was hiding: six cards. Settings first, then the four ad networks and the direct links. Every network starts OFF — nothing is served until you turn one on — and each card shows its state at a glance, so you never have to open one to check it.
Where: Monetization9:41‹MonetizationMini app setupTurn on the ad networks you want for this bot and enter your own account IDs.
Settings 5s · 30s A Adsgram Off M Monetag Off G GigaPub Off R RichAds Off Direct links OffSix cards, all off. A greyed-out logo means that network is not running.
-
Get your zone from Monetag
Before opening the card you need the zone. In your Monetag dashboard, add the mini app and create a zone for it; Monetag then gives you a script tag that looks like <script src="//libtl.com/sdk.js" data-zone="11250496" data-sdk="show_11250496">. Copy the whole tag — you do not need to pick the number out of it.
Where: monetag.com → your dashboardYou need a Monetag publisher account for this. Registration is free and the link is at the end of this guide.
<script src="//libtl.com/sdk.js" data-zone="11250496" data-sdk="show_11250496"></script>data-zone="11250496" -
Open the Monetag card and paste it
Back in Monetization, tap the Monetag card. It opens centred over the grid with one field: Zone ID. Paste the whole script tag into it — the panel pulls the zone out by itself. This matters more than it sounds: the tag contains the zone twice, and hand-copying it used to produce a doubled number that looked valid and silently served nothing.
Where: Monetization → Monetag → Zone IDTurn the switch ON before saving. It sits in the header next to the name, not inside the form — a saved zone with the switch off never loads an ad.
9:41‹MonetizationTurn on the ad networks you want for this bot and enter your own account IDs.
Monetag
Rewarded and interstitial. Both join your rotation.
Enable this network The switch lives in the card header, beside the name.11250496From libtl.com. Drives show_<zone>.
SaveCancelThe modal opens centred over the network grid.
-
Check the card turned green
After saving, the grid is how you verify the state without opening anything. Monetag now shows a green dot and the word On, and its logo is in full colour. If it says Needs ID in amber, the switch is on but the zone did not save. If it still says Off, the switch was not turned on.
Where: Monetization9:41‹MonetizationMini app setupTurn on the ad networks you want for this bot and enter your own account IDs.
Settings 5s · 30s A Adsgram Off M Monetag On G GigaPub Off R RichAds Off Direct links OffGreen dot and On. Amber and "Needs ID" means the zone did not save.
-
Set when the ads appear
The Settings card is the clock for this mini app: how long after opening the first ad shows, and how often after that. The defaults are 5 seconds and then every 30. While you are testing, leave the first one at 5 so you do not have to wait around.
Where: Monetization → Settings9:41‹MonetizationTurn on the ad networks you want for this bot and enter your own account IDs.
Ad timing
Seconds. Min 5. Then one every 30 seconds.
Network sweep All your networks in the same cycle, random order — two networks, twice the impressions.SaveCancel5The Settings card shows these two numbers instead of an on/off state.
-
Open your mini app inside Telegram and wait
This is the only test that proves anything. Open your bot in Telegram and launch the mini app from the chat — not from a desktop browser, because the Monetag SDK needs the Telegram WebApp to be present. Wait out the delay you set and the first ad should appear. A card reading On and an ad that actually shows up are two different things, and only the second one pays.
Where: Telegram → your bot → open the mini appIf nothing shows: the zone is wrong, the switch is off, or you are testing outside Telegram. Those three cover almost every case.
Welcome to Gold Rush. Tap below to open the app.Open app— first ad appears after 5 seconds —
Your Monetag zone is live
Impressions from this point are billed to your Monetag account rather than ours. You can turn on a second network the same way, and the Settings card has a sweep mode that runs them in the same cycle instead of one at a time.
Build your Mini App free ↗To monetize a Telegram Mini App with Monetag, publish a working HTTPS Mini App, create a Monetag publisher account and ad zone, add the official SDK or generated ad tag, trigger the chosen format at a natural point in the user journey, and test frequency, rewards and callbacks before increasing traffic.
Monetization starts with a product loop, not an ad tag
Advertising pays when a real audience returns often enough to create quality impressions. Placing more ads into a weak loop does not repair retention; it gives users another reason to leave. First decide what the user values, then use advertising at moments that preserve that value exchange.
Monetag’s own guidance warns against overloading a Mini App interface and recommends moderate frequency. The practical goal is revenue per retained user, not the maximum number of ads in one session.
What you need
- A working Telegram bot connected to the Mini App
- A production Mini App served over HTTPS
- JavaScript support in the Telegram WebView
- A Monetag publisher account
- An approved app or zone and its generated tag
- A documented trigger and reward rule
- Real-device tests before public promotion
Understand the three main Monetag formats
Monetag documents all three through its Telegram Mini App SDK. Rewarded formats are easiest to explain because the exchange is visible. Passive interstitials require stricter frequency and timing because the user did not explicitly request them.
| Format | How it appears | Best placement |
|---|---|---|
| Rewarded Interstitial | The user intentionally views an ad in exchange for an in-app reward | Boosts, extra energy, bonus claim or an optional reward |
| Rewarded Popup | The user accepts a prompt and continues to an offer | An explicit “earn more” or sponsored action |
| In-App Interstitial | A full-screen format shown at a publisher-defined moment | Natural breaks such as returning to the home screen or completing a round |
The integration workflow
- Create the publisher account
Register with Monetag and complete any required publisher information.
- Add the Mini App
Use the production app URL and follow the current moderation requirements.
- Create an ad zone
Choose the format that matches the user moment you designed.
- Get the official tag or SDK configuration
The generated zone identifier connects impressions and reporting to your account.
- Connect it to the app
Use your builder’s advertising credential settings or follow Monetag’s official SDK integration when working with custom code.
- Define the trigger
Decide exactly what user action can request an ad and what happens after success, skip or failure.
- Test callbacks and frequency
Verify rewards are granted only under the intended conditions and that an unavailable ad never blocks the product.
Where Mini Empire fits
Free Mini Empire projects launch with platform branding and monetization included. This lets a creator validate the product loop before setting up an independent advertising account. The one-time ownership unlock removes platform branding and enables the project owner to use their own advertising credentials.
That sequence reduces premature optimization: first prove people use the app, then own and tune the revenue layer. Always follow the current settings and supported formats shown inside the builder.
A placement map that protects the experience
| User moment | Ad decision | Why |
|---|---|---|
| First app open | Avoid or delay | The user has not received value or understood the product yet |
| Optional bonus | Rewarded format | The value exchange is explicit and user initiated |
| Round or task completed | Possible interstitial | There is a natural transition and no input is interrupted |
| Withdrawal or sensitive action | Avoid | Advertising can weaken trust at a high-stakes moment |
| Return session | Frequency-controlled | Use history to avoid showing the same interruption too often |
Calculate the model before buying traffic
A simplified advertising estimate is: monetized impressions divided by 1,000, multiplied by effective CPM. Actual CPM is dynamic and can change by country, device, format, placement, traffic quality and advertiser demand. Monetag explicitly notes this variability, so treat any public rate as context—not a promise.
The decision metric is contribution per acquired user: advertising revenue plus other revenue, minus rewards, promotion cost, fraud and payment expense. If that number is negative, scaling traffic scales the loss.
Estimated ad revenue = (monetized impressions ÷ 1,000) × effective CPMMistakes that reduce revenue even when impressions rise
- Granting rewards before confirming the ad result.
- Blocking the app when no ad is available.
- Showing an ad before the first useful action.
- Using identical frequency for new and returning users.
- Buying low-quality traffic that creates invalid activity.
- Ignoring country and device differences in the audience.
- Changing several placements at once and losing the ability to learn.
- Promising earnings to users without clear, sustainable rules.
A responsible first experiment
- Choose one optional rewarded placement
Do not launch three formats simultaneously.
- Limit exposure
Begin with conservative per-user frequency.
- Measure the control period
Know retention and task completion before the ad goes live.
- Compare retained-user revenue
Watch both revenue and the percentage of users who return.
- Expand only after stability
Add another placement only when callbacks, UX and traffic quality are reliable.
Common questions
Can a new Telegram Mini App use Monetag?
Monetag says Mini Apps can be monetized regardless of size, subject to its current account, traffic and moderation requirements.
Which Monetag format is best for a Mini App?
There is no universal winner. Rewarded formats fit optional value exchanges; in-app interstitials fit natural breaks and require more careful frequency.
Does Monetag guarantee a CPM?
No. Monetag states that CPM changes with geography, device, placement, frequency, traffic quality and other factors.
Can I use my own Monetag credentials in Mini Empire?
An owned Mini Empire project can use the owner’s advertising credentials. Check the active builder settings for the currently supported integrations and fields.
Sources and further reading
Technical and product claims were checked against these primary sources.