npm, PyPI ve GitHub’daki resmi açık kaynak paketlerimiz. Telegram Mini App’inize ödüllü, geçiş ve görev reklamları, botunuza sponsorlu mesajlar ekleyin ve USDT kazanın.
Adsun npm i adsun-sdkpip install adsunReact · Vue · Next.js · TypeScript · Python · aiogram · python-telegram-bot
Telegram Mini App’ler için JavaScript ve TypeScript. React hook, Vue composable, SSR uyumlu.
Telegram botları için Python. aiogram ve python-telegram-bot yardımcıları, Reward URL doğrulama.
Tüm kaynak kod, örnekler, sorun takibi ve sürüm notları. MIT lisanslı.
Derleme yok: https://api.adsun.io/sdk.js dosyasını yükleyin, Adsun.init() çağırın.
50001 yerine Adsun yayıncı panelindeki blok kimliğinizi yazın. Test ederken debug: true kullanın — test reklamları asla ücretlendirilmez.
Her Mini App, derleyici gerekmez.
<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));
Ödüllü buton ve görev kartı.
// 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)} />
</>
);
}
Her bileşen için composable.
<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>
/bonus komutunda sponsorlu mesaj.
# 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")
Ödülü yalnızca doğrulanmış izlemeden sonra verin.
# 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}
Kullanıcının uygulama içi ödül için izlemeyi seçtiği tam ekran video veya görsel.
Blok kimliği: 50001
Ekranlar arasında tam ekran reklam, birkaç saniye sonra kapatılabilir.
Blok kimliği: int-50001
Yerel <adsun-task> kartı: kanal, bot veya uygulamayı aç, geri dön ve ödülü al.
Blok kimliği: task-50001
Telegram botunuzun gönderdiği butonlu sponsorlu mesaj.
Blok kimliği: 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>
SDK kullanımı ücretsiz. Kodu GitHub’da okuyun, çatallayın, denetleyin.
AdController, olaylar ve init seçenekleri için tam tipler.
Her yerde import edin; script yalnızca tarayıcıda yüklenir.
Çekirdek yalnızca standart kütüphaneyi kullanır; async ekleri isteğe bağlı.
Reward URL yalnızca Adsun tam izlemeyi doğruladıktan sonra çağrılır.
Aynı init({ blockId }).show() akışı — dakikalar içinde geçiş yapın.
Telegram Mini App için npm i adsun-sdk çalıştırın (veya <script src="https://api.adsun.io/sdk.js"> ekleyin). Telegram botları için pip install adsun çalıştırın.
Evet. Paketler MIT lisanslı açık kaynaktır. Gösterilen reklamlardan para kazanırsınız; SDK ücreti yoktur.
Evet. useAdsun hook’u ve AdsunTask bileşeni için adsun-sdk/react, Vue 3 için adsun-sdk/vue kullanın. SSR uyumlu olduğu için Next.js ve Nuxt’ta da çalışır.
adsun paketini kurun, AdsunBot(token, block_id) oluşturup get_ad(user_id, language) çağırın ya da hazır aiogram / python-telegram-bot yardımcısı send_ad() kullanın.
Bloğunuza bir Reward URL girin. Adsun bu adresi yalnızca sunucuda doğrulanmış tam izlemeden sonra çağırır; parse_reward_callback() ile doğrulayıp ödülü orada verin.
Evet. API aynı init({ blockId }).show() yapısını ve aynı olayları kullanır; çoğu entegrasyonda yalnızca script ve blok kimliği değişir.
Bir blok oluşturun, paketi kurun ve ilk gösterimlerinizi bugün görün.
npm i adsun-sdkpip install adsun