Paket resmi open source di npm, PyPI, dan GitHub. Tambahkan iklan rewarded, interstitial, dan tugas ke Telegram Mini App Anda, atau pesan bersponsor ke bot Anda, dan dapatkan USDT.
Adsun npm i adsun-sdkpip install adsunReact · Vue · Next.js · TypeScript · Python · aiogram · python-telegram-bot
JavaScript & TypeScript untuk Telegram Mini Apps. Hook React, composable Vue, aman untuk SSR.
Python untuk bot Telegram. Helper aiogram & python-telegram-bot, verifikasi Reward URL.
Kode sumber lengkap, contoh, issues, dan changelog. Lisensi MIT.
Tanpa build: muat https://api.adsun.io/sdk.js lalu panggil Adsun.init().
Ganti 50001 dengan ID blok dari panel publisher Adsun Anda. Gunakan debug: true saat pengujian — iklan uji tidak pernah ditagih.
Mini App apa pun, tanpa bundler.
<script src="https://telegram.org/js/telegram-web-app.js"></script>
<script src="https://api.adsun.io/sdk.js"></script>
<script>
// Reward block (Interstitial: "int-50001")
const ad = window.Adsun.init({ blockId: "50001" });
document.querySelector("#watch").onclick = () =>
ad.show().then(() => giveReward()).catch(console.log);
</script>
<adsun-task data-block-id="task-50003">
<span slot="reward">+100 coins</span>
</adsun-task>
Vite, Next.js, Svelte, Angular.
// npm i adsun-sdk
import { initAdsun } from "adsun-sdk";
const ad = await initAdsun({ blockId: "50001", debug: false });
ad.addEventListener("onStart", () => pauseGame());
ad.show()
.then((r) => r.done && giveReward())
.catch((r) => console.log(r.description));
Tombol rewarded dan kartu tugas.
// npm i adsun-sdk
import { useAdsun, AdsunTask } from "adsun-sdk/react";
export function Earn() {
const showAd = useAdsun({ blockId: "50001", onReward: () => addCoins(100) });
return (
<>
<button onClick={showAd}>Watch ad · +100</button>
<AdsunTask blockId="task-50003" reward="+100" onReward={() => addCoins(100)} />
</>
);
}
Composable untuk komponen apa pun.
<script setup>
// npm i adsun-sdk
import { useAdsun } from "adsun-sdk/vue";
const showAd = useAdsun({ blockId: "50001", onReward: () => coins.value += 100 });
</script>
<template>
<button @click="showAd">Watch ad · +100</button>
</template>
Pesan bersponsor di /bonus.
# pip install "adsun[aiogram]"
from aiogram.filters import Command
from adsun import AsyncAdsunBot
from adsun.integrations.aiogram import send_ad
ads = AsyncAdsunBot(token="YOUR_ACCOUNT_TOKEN", block_id="50001")
@dp.message(Command("bonus"))
async def bonus(message):
u = message.from_user
await send_ad(message.bot, message.chat.id, ads, u.id, u.language_code or "en")
Berikan hadiah hanya setelah tayangan terverifikasi.
# Panel → Reward URL:
# https://your-app.com/adsun/reward?userid=[userId]&block=[blockId]&secret=SECRET
from adsun import parse_reward_callback
@app.get("/adsun/reward")
def reward(request):
cb = parse_reward_callback(request.query_params, secret=SECRET)
if cb is None:
return Response(status_code=403)
add_coins(cb.user_id) # idempotent: Adsun retries on 5xx
return {"ok": True}
Video atau gambar layar penuh yang dipilih pengguna untuk ditonton demi hadiah dalam aplikasi.
ID blok: 50001
Iklan layar penuh di antara layar, bisa ditutup setelah beberapa detik.
ID blok: int-50001
Kartu native <adsun-task>: buka channel, bot, atau aplikasi, kembali, lalu klaim.
ID blok: task-50001
Pesan bersponsor dengan tombol yang dikirim bot Telegram Anda.
ID blok: 50001 · Bot
# Telegram Mini App
npm i adsun-sdk
# Telegram bot
pip install adsun
# No build step
<script src="https://api.adsun.io/sdk.js"></script>
Tanpa biaya memakai SDK. Baca, fork, dan audit kodenya di GitHub.
Tipe lengkap untuk AdController, event, dan opsi init.
Impor di mana saja; script hanya dimuat di browser.
Inti hanya memakai library standar; ekstra async opsional.
Reward URL dipanggil hanya setelah Adsun memverifikasi tayangan penuh.
Alur init({ blockId }).show() yang sama — migrasi dalam hitungan menit.
Untuk Telegram Mini Apps jalankan npm i adsun-sdk (atau tambahkan <script src="https://api.adsun.io/sdk.js">). Untuk bot Telegram jalankan pip install adsun.
Ya. Paketnya open source dengan lisensi MIT. Anda mendapat uang dari iklan yang ditampilkan; tidak ada biaya SDK.
Ya. Gunakan adsun-sdk/react untuk hook useAdsun dan komponen AdsunTask, serta adsun-sdk/vue untuk Vue 3. Aman untuk SSR, jadi berjalan di Next.js dan Nuxt.
Instal adsun, buat AdsunBot(token, block_id) lalu panggil get_ad(user_id, language), atau gunakan helper send_ad() untuk aiogram / python-telegram-bot.
Atur Reward URL pada blok Anda. Adsun memanggilnya hanya setelah tayangan penuh terverifikasi server; validasi dengan parse_reward_callback() dan berikan hadiah di sana.
Bisa. API memakai pola init({ blockId }).show() dan event yang sama, sehingga biasanya hanya script dan ID blok yang berubah.
Buat blok, instal paketnya, dan lihat tayangan pertama Anda hari ini.
npm i adsun-sdkpip install adsun