مفتوح المصدر · MIT · مجاني · v1.0.0

Adsun SDK: إعلانات تطبيقات Telegram المصغّرة والبوتات بسطر برمجي واحد

حزم رسمية مفتوحة المصدر على 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 عادي

أي تطبيق مصغّر بدون أدوات بناء.

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}
صيغ الإعلانات

كل صيغ إعلانات Telegram في SDK واحد

بمكافأة

فيديو أو صورة بملء الشاشة يختار المستخدم مشاهدتها مقابل مكافأة داخل التطبيق.

معرّف الكتلة: 50001

بيني (Interstitial)

إعلان بملء الشاشة بين الشاشات، يمكن إغلاقه بعد ثوانٍ.

معرّف الكتلة: int-50001

مهمة (Task)

بطاقة <adsun-task> أصلية: افتح قناة أو بوتًا أو تطبيقًا، ثم عُد واستلم المكافأة.

معرّف الكتلة: task-50001

رسالة بوت

رسالة مموّلة بأزرار يرسلها بوت Telegram الخاص بك.

معرّف الكتلة: 50001 · Bot

كيف يعمل

جاهز في أربع خطوات

  1. 1أنشئ حساب ناشر مجانيًا على adsun.io.
  2. 2أضف تطبيقك المصغّر أو بوتك وأنشئ كتلة إعلانية.
  3. 3ثبّت adsun-sdk (npm) أو adsun (PyPI) والصق معرّف الكتلة.
  4. 4اضبط Reward 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>
لماذا يختاره المطوّرون

صُمّم لمطوّري Telegram

مجاني وبترخيص MIT

لا رسوم لاستخدام SDK. اقرأ الشيفرة وانسخها وراجعها على GitHub.

أنواع TypeScript

تعريفات كاملة لـ AdController والأحداث وخيارات init.

متوافق مع SSR

استورده في أي مكان؛ السكربت يُحمَّل في المتصفح فقط.

Python بلا تبعيات

النواة تستخدم المكتبة القياسية فقط؛ إضافات async اختيارية.

مكافآت يتحقق منها الخادم

لا يُستدعى Reward URL إلا بعد أن تتحقق Adsun من المشاهدة الكاملة.

واجهة متوافقة مع AdsGram

نفس تدفّق init({ blockId }).show() — انتقل خلال دقائق.

الأسئلة

أسئلة حول Adsun SDK

كيف أثبّت Adsun SDK؟

لتطبيقات Telegram المصغّرة نفّذ npm i adsun-sdk (أو أضف <script src="https://api.adsun.io/sdk.js">). ولبوتات Telegram نفّذ pip install adsun.

هل Adsun SDK مجاني؟

نعم. الحزم مفتوحة المصدر بترخيص MIT. تربح من الإعلانات المعروضة ولا توجد رسوم على SDK.

هل يعمل مع React وVue وNext.js؟

نعم. استخدم adsun-sdk/react للحصول على useAdsun ومكوّن AdsunTask، وadsun-sdk/vue لـ Vue 3. وهو متوافق مع SSR فيعمل في Next.js وNuxt.

كيف أربح من بوت Telegram باستخدام Python؟

ثبّت adsun وأنشئ AdsunBot(token, block_id) ثم استدعِ get_ad(user_id, language)، أو استخدم الدالة الجاهزة send_ad() لـ aiogram أو python-telegram-bot.

كيف أمنح المكافآت بأمان؟

اضبط Reward URL للكتلة. تستدعيه Adsun فقط بعد مشاهدة كاملة يتحقق منها الخادم؛ تحقّق منه عبر parse_reward_callback() وامنح المكافأة هناك.

هل يمكنني الانتقال من AdsGram؟

نعم. الواجهة تتبع نمط init({ blockId }).show() نفسه والأحداث نفسها، لذا يتغيّر غالبًا السكربت ومعرّف الكتلة فقط.

ابدأ الربح من زيارات Telegram

أنشئ كتلة، ثبّت الحزمة، وشاهد أولى مرات الظهور اليوم.

npm i adsun-sdk
pip install adsun

Want to try?

See real Adsun ads live in Telegram.