Официальные open-source пакеты в npm, PyPI и на GitHub. Добавьте rewarded, interstitial и task-рекламу в свой Telegram Mini App или спонсорские сообщения в бота и зарабатывайте USDT.
Adsun npm i adsun-sdkpip install adsunReact · Vue · Next.js · TypeScript · Python · aiogram · python-telegram-bot
JavaScript и TypeScript для Telegram Mini Apps. React-хук, Vue composable, безопасно для SSR.
Python для Telegram-ботов. Хелперы для aiogram и python-telegram-bot, проверка Reward URL.
Полный исходный код, примеры, issues и changelog. Лицензия MIT.
Без сборки: подключите https://api.adsun.io/sdk.js и вызовите Adsun.init().
Замените 50001 на ID блока из кабинета паблишера Adsun. При тестировании используйте debug: true — тестовые показы не оплачиваются.
Любой Mini App без сборщика.
<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));
Кнопка с наградой и карточка задания.
// 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 для любого компонента.
<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.
# 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")
Начисляйте награду только после проверенного просмотра.
# 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}
Полноэкранное видео или изображение, которое пользователь смотрит ради награды в приложении.
ID блока: 50001
Полноэкранная реклама между экранами, закрывается через несколько секунд.
ID блока: int-50001
Нативная карточка <adsun-task>: открыть канал, бота или приложение, вернуться и забрать награду.
ID блока: task-50001
Спонсорское сообщение с кнопками от вашего Telegram-бота.
ID блока: 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 без платы. Читайте, форкайте и проверяйте код на GitHub.
Полная типизация AdController, событий и опций init.
Импортируйте где угодно — скрипт загружается только в браузере.
Ядро на стандартной библиотеке; async-дополнения по желанию.
Reward URL вызывается только после того, как Adsun подтвердил полный просмотр.
Тот же поток init({ blockId }).show() — переход за минуты.
Для Telegram Mini Apps выполните npm i adsun-sdk (или подключите <script src="https://api.adsun.io/sdk.js">). Для Telegram-ботов — pip install adsun.
Да. Пакеты открыты под лицензией MIT. Вы зарабатываете на показах рекламы, платы за SDK нет.
Да. adsun-sdk/react даёт хук useAdsun и компонент AdsunTask, adsun-sdk/vue — composable для Vue 3. SDK безопасен для SSR, поэтому работает в Next.js и Nuxt.
Установите adsun, создайте AdsunBot(token, block_id) и вызовите get_ad(user_id, language) или используйте готовый хелпер send_ad() для aiogram / python-telegram-bot.
Укажите Reward URL для блока. Adsun вызывает его только после проверенного сервером полного просмотра; проверьте запрос через parse_reward_callback() и начисляйте награду там.
Да. API повторяет схему init({ blockId }).show() и те же события, поэтому обычно меняются только скрипт и ID блока.
Создайте блок, установите пакет и получите первые показы уже сегодня.
npm i adsun-sdkpip install adsun