npm、PyPI 和 GitHub 上的官方开源包。为你的 Telegram 小程序添加激励、插屏和任务广告，或为机器人添加赞助消息，赚取 USDT。
Adsun npm i adsun-sdkpip install adsunReact · Vue · Next.js · TypeScript · Python · aiogram · python-telegram-bot
把 50001 替换为 Adsun 发布商后台中的广告位 ID。测试时使用 debug: true —— 测试广告永不计费。
任意小程序，无需打包工具。
<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 阅读、Fork 和审计代码。
AdController、事件与 init 选项均有完整类型。
随处导入，脚本只在浏览器中加载。
核心仅用标准库，async 扩展可选。
只有在 Adsun 验证完整观看后才会调用 Reward URL。
相同的 init({ blockId }).show() 流程，几分钟即可迁移。
Telegram 小程序运行 npm i adsun-sdk（或添加 <script src="https://api.adsun.io/sdk.js">）。Telegram 机器人运行 pip install adsun。
免费。软件包以 MIT 许可开源。你通过展示广告获得收入，SDK 不收取任何费用。
支持。adsun-sdk/react 提供 useAdsun Hook 和 AdsunTask 组件，adsun-sdk/vue 适用于 Vue 3。SDK 支持 SSR，可在 Next.js 和 Nuxt 中使用。
安装 adsun，创建 AdsunBot(token, block_id) 并调用 get_ad(user_id, language)，或直接使用为 aiogram / python-telegram-bot 准备的 send_ad()。
为广告位设置 Reward URL。Adsun 只会在服务端验证完整观看后调用它；用 parse_reward_callback() 校验后再发放奖励。
可以。API 采用相同的 init({ blockId }).show() 模式和相同事件，通常只需更换脚本和广告位 ID。