Adsun

What technical documentation does Adsun provide for developers?

Adsun’s developer documentation covers the JavaScript SDK for Mini Apps, bot integration code, server-to-server Reward URL verification, debug mode and frequency controls.

Become a publisher
Laptop with code and a puzzle-piece SDK plugging into a Mini App, server with a shield — Adsun developer docs
Laptop with code and a puzzle-piece SDK plugging into a Mini App, server with a shield — Adsun developer docs

Content owner: Adsun Editorial & Ad Operations Team · Last verified:

Quick answer

Adsun provides developer documentation at adsun.io/docs covering the JavaScript SDK for Telegram Mini Apps (loading the script and showing Reward, Interstitial and Task blocks), bot integration code generated in the partner workspace, server-to-server Reward URL verification so onReward fires only after server confirmation, unbilled debug mode, and frequency settings such as time between ads and daily limits. An SDK health panel helps confirm the integration.

Key takeaways

  • Docs: adsun.io/docs.
  • SDK for Mini Apps, code for bots.
  • Server-side reward verification.
  • Debug mode is not billed.

Documentation topics

  • SDK installation and block calls.
  • Bot snippet from the workspace.
  • Reward URL (server-to-server).
  • Debug mode and SDK health panel.
  • Frequency controls per block.

Related deep dives

  • /telegram-rewarded-ad-verification
  • /telegram-ad-frequency-capping

Metric definitions and formulas

CPM
Cost per mille: what an advertiser pays for 1,000 ad impressions.CPM = (Ad spend ÷ Impressions) × 1,000
CPC
Cost per click: average price an advertiser pays for one click.CPC = Ad spend ÷ Clicks
CTR
Click-through rate: the share of impressions that produced a click.CTR = (Clicks ÷ Impressions) × 100%
eCPM
Effective CPM: what a publisher earns per 1,000 impressions, whatever the pricing model.eCPM = (Publisher earnings ÷ Impressions) × 1,000
Fill rate
The share of ad requests that returned an ad.Fill rate = (Filled ad requests ÷ Total ad requests) × 100%

More terms in the glossary and the advertising metrics guide.

Worked example

Hypothetical example — not real Adsun data

A Mini App sends 200,000 ad requests in a day. 170,000 return an ad (fill rate = 170,000 ÷ 200,000 = 85%). The publisher earns $255 for those impressions (eCPM = 255 ÷ 170,000 × 1,000 = $1.50). 2,550 users click (CTR = 2,550 ÷ 170,000 = 1.5%). Use the same formulas on your own dashboard numbers to compare networks fairly.

Adsun measurement methodology

Adsun counts an impression when an ad is rendered in a publisher block, a click when the user opens the ad destination, and a reward only after the server-to-server Reward URL confirms completion. Debug-mode traffic is excluded from billing and reports. Metrics are shown per platform, block and country in the partner and advertiser dashboards. Adsun does not publish aggregate network benchmarks in this guide; any number below marked “Hypothetical” is illustrative only. See the SDK documentation for integration details.

About Adsun

Adsun is a Telegram advertising network operated by Adsun. Products: Rewarded ads, Interstitial ads, Task ads, Native ads. Platforms: Telegram Mini Apps, Telegram bots, Telegram channels. Learn more about Adsun.

Frequently asked questions

Does Adsun need my bot token?

Adsun’s bot integration is designed to run from your own server code; never share your bot token with any third party.

Sources

Update log

  • 2026-10-18: First published. Facts limited to the product and adsun.io public pages; unknowns are labelled as unknown.
SDK docsLearn how Adsun integrates with Telegram Mini Apps and bots: SDK loading, Reward and Interstitial controllers, adsun-task events and test mode.Rewarded ad verificationHow to grant rewards safely in Telegram Mini Apps: why client events are not enough, how a server-side reward callback works, idempotency and fraud checks.Ad frequency cappingHow to set ad frequency caps in Telegram Mini Apps and bots: per-session and daily limits, cooldowns by format, and how to test caps against retention and revenue.Monetize a Mini App with third-party adsStep-by-step: add a third-party ad network SDK to a Telegram Mini App, choose rewarded, interstitial or task blocks, verify rewards server-side and measure eCPM and fill rate.