متن‌باز · MIT · رایگان · v1.0.0

Adsun SDK: تبلیغات مینی‌اپ و ربات تلگرام با یک خط کد

پکیج‌های رسمی و متن‌باز در npm، PyPI و GitHub. تبلیغات جایزه‌دار، تمام‌صفحه و تسک را به مینی‌اپ تلگرام خود یا پیام‌های اسپانسری را به ربات خود اضافه کنید و USDT درآمد داشته باشید.

npm i adsun-sdk
pip install adsun

React · Vue · Next.js · TypeScript · Python · aiogram · python-telegram-bot

با مدیر پکیج دلخواه خود نصب کنید

شروع سریع

کپی کنید، بچسبانید، درآمد بگیرید

به‌جای 50001 شناسه بلاک خود را از پنل ناشر Adsun وارد کنید. هنگام تست از debug: true استفاده کنید — تبلیغات آزمایشی هرگز هزینه ندارند.

HTML ساده

هر مینی‌اپ، بدون bundler.

index.html
<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>

npm / TypeScript

Vite، Next.js، Svelte، Angular.

main.ts
// 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));

React

دکمه جایزه‌دار و کارت تسک.

Earn.tsx
// 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)} />
    </>
  );
}

Vue 3

Composable برای هر کامپوننت.

Earn.vue
<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>

ربات Python (aiogram)

پیام اسپانسری با /bonus.

bot.py
# 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")

Reward URL (سرور)

جایزه را فقط پس از تماشای تأییدشده بدهید.

reward.py
# 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}
فرمت‌های تبلیغ

همه فرمت‌های تبلیغات تلگرام در یک SDK

جایزه‌دار

ویدیو یا تصویر تمام‌صفحه که کاربر برای دریافت جایزه درون‌برنامه‌ای تماشا می‌کند.

شناسه بلاک: 50001

تمام‌صفحه (Interstitial)

تبلیغ تمام‌صفحه بین صفحه‌ها که پس از چند ثانیه بسته می‌شود.

شناسه بلاک: int-50001

تسک (Task)

کارت بومی <adsun-task>: کانال، ربات یا اپ را باز کن، برگرد و جایزه بگیر.

شناسه بلاک: task-50001

پیام ربات

پیام اسپانسری دکمه‌دار که ربات تلگرام شما ارسال می‌کند.

شناسه بلاک: 50001 · Bot

روش کار

راه‌اندازی در چهار مرحله

  1. 1در adsun.io حساب ناشر رایگان بسازید.
  2. 2مینی‌اپ یا ربات خود را اضافه کرده و یک بلاک تبلیغاتی بسازید.
  3. 3adsun-sdk (npm) یا adsun (PyPI) را نصب و شناسه بلاک را وارد کنید.
  4. 4Reward URL را تنظیم کنید، در حالت debug تست کنید و منتشر کنید.
terminal
# Telegram Mini App
npm i adsun-sdk

# Telegram bot
pip install adsun

# No build step
<script src="https://api.adsun.io/sdk.js"></script>
چرا توسعه‌دهندگان انتخابش می‌کنند

ساخته‌شده برای توسعه‌دهندگان تلگرام

رایگان با مجوز MIT

استفاده از SDK هزینه ندارد. کد را در GitHub بخوانید، فورک و بررسی کنید.

تایپ‌های TypeScript

تایپ کامل برای AdController، رویدادها و گزینه‌های init.

سازگار با SSR

هر جا import کنید؛ اسکریپت فقط در مرورگر بارگذاری می‌شود.

Python بدون وابستگی

هسته فقط از کتابخانه استاندارد استفاده می‌کند؛ افزونه‌های async اختیاری‌اند.

جایزه با تأیید سرور

Reward URL فقط پس از تأیید تماشای کامل توسط Adsun فراخوانی می‌شود.

API سازگار با AdsGram

همان روند init({ blockId }).show() — در چند دقیقه مهاجرت کنید.

پرسش‌ها

پرسش‌های رایج درباره Adsun SDK

Adsun SDK را چطور نصب کنم؟

برای مینی‌اپ‌های تلگرام دستور npm i adsun-sdk را اجرا کنید (یا <script src="https://api.adsun.io/sdk.js"> را اضافه کنید). برای ربات‌های تلگرام pip install adsun را اجرا کنید.

آیا Adsun SDK رایگان است؟

بله. پکیج‌ها متن‌باز و با مجوز MIT هستند. شما از تبلیغات نمایش‌داده‌شده درآمد دارید و SDK هزینه‌ای ندارد.

با React، Vue و Next.js کار می‌کند؟

بله. برای هوک useAdsun و کامپوننت AdsunTask از adsun-sdk/react و برای Vue 3 از adsun-sdk/vue استفاده کنید. سازگار با SSR است و در Next.js و Nuxt کار می‌کند.

چطور با Python از ربات تلگرام درآمد داشته باشم؟

adsun را نصب کنید، AdsunBot(token, block_id) بسازید و get_ad(user_id, language) را صدا بزنید، یا از send_ad() آماده برای aiogram / python-telegram-bot استفاده کنید.

چطور جایزه را امن بدهم؟

برای بلاک خود Reward URL تنظیم کنید. Adsun فقط پس از تماشای کامل تأییدشده در سرور آن را فراخوانی می‌کند؛ با parse_reward_callback() بررسی و همان‌جا جایزه بدهید.

می‌توانم از AdsGram مهاجرت کنم؟

بله. API همان الگوی init({ blockId }).show() و همان رویدادها را دارد، بنابراین معمولاً فقط اسکریپت و شناسه بلاک تغییر می‌کند.

از ترافیک تلگرام خود درآمد کسب کنید

یک بلاک بسازید، پکیج را نصب کنید و اولین نمایش‌ها را همین امروز ببینید.

npm i adsun-sdk
pip install adsun

Want to try?

See real Adsun ads live in Telegram.