ओपन सोर्स · MIT · मुफ़्त · v1.0.0

Adsun SDK: एक लाइन कोड से Telegram Mini App और बॉट विज्ञापन

npm, PyPI और GitHub पर आधिकारिक ओपन-सोर्स पैकेज। अपने Telegram Mini App में रिवॉर्डेड, इंटरस्टीशियल और टास्क विज्ञापन या अपने बॉट में प्रायोजित संदेश जोड़ें और USDT कमाएं।

npm i adsun-sdk
pip install adsun

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

अपने पसंदीदा पैकेज मैनेजर से इंस्टॉल करें

क्विक स्टार्ट

कॉपी करें, पेस्ट करें, कमाएं

50001 की जगह Adsun पब्लिशर पैनल से अपना ब्लॉक ID डालें। टेस्ट करते समय debug: true इस्तेमाल करें — टेस्ट विज्ञापनों का कभी शुल्क नहीं लगता।

सादा HTML

कोई भी Mini App, बिना 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}
विज्ञापन फ़ॉर्मेट

हर Telegram विज्ञापन फ़ॉर्मेट, एक SDK में

रिवॉर्डेड

फ़ुलस्क्रीन वीडियो या इमेज जिसे यूज़र इन-ऐप रिवॉर्ड के लिए देखना चुनता है।

ब्लॉक ID: 50001

इंटरस्टीशियल

स्क्रीनों के बीच फ़ुलस्क्रीन विज्ञापन, कुछ सेकंड बाद बंद किया जा सकता है।

ब्लॉक ID: int-50001

टास्क

नेटिव <adsun-task> कार्ड: चैनल, बॉट या ऐप खोलें, लौटें और क्लेम करें।

ब्लॉक ID: task-50001

बॉट संदेश

आपके Telegram बॉट द्वारा भेजा गया बटन वाला प्रायोजित संदेश।

ब्लॉक ID: 50001 · Bot

यह कैसे काम करता है

चार स्टेप में लाइव

  1. 1adsun.io पर मुफ़्त पब्लिशर अकाउंट बनाएं।
  2. 2अपना Mini App या बॉट जोड़ें और एक विज्ञापन ब्लॉक बनाएं।
  3. 3adsun-sdk (npm) या adsun (PyPI) इंस्टॉल करें और ब्लॉक ID पेस्ट करें।
  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 पर कोड पढ़ें, fork और ऑडिट करें।

TypeScript टाइप्स

AdController, इवेंट्स और init विकल्पों की पूरी टाइपिंग।

SSR-सुरक्षित

कहीं भी import करें; स्क्रिप्ट सिर्फ़ ब्राउज़र में लोड होती है।

बिना डिपेंडेंसी Python

कोर सिर्फ़ स्टैंडर्ड लाइब्रेरी इस्तेमाल करता है; async एक्स्ट्रा वैकल्पिक हैं।

सर्वर-सत्यापित रिवॉर्ड

Reward URL तभी कॉल होता है जब Adsun पूरा व्यू सत्यापित कर ले।

AdsGram-संगत API

वही init({ blockId }).show() फ़्लो — मिनटों में माइग्रेट करें।

FAQ

Adsun SDK से जुड़े सवाल

Adsun SDK कैसे इंस्टॉल करें?

Telegram Mini Apps के लिए npm i adsun-sdk चलाएं (या <script src="https://api.adsun.io/sdk.js"> जोड़ें)। Telegram बॉट्स के लिए 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 से Telegram बॉट से कमाई कैसे करें?

adsun इंस्टॉल करें, AdsunBot(token, block_id) बनाएं और get_ad(user_id, language) कॉल करें, या aiogram / python-telegram-bot के लिए तैयार send_ad() हेल्पर इस्तेमाल करें।

रिवॉर्ड सुरक्षित तरीके से कैसे दें?

अपने ब्लॉक पर Reward URL सेट करें। Adsun इसे सर्वर-सत्यापित पूरे व्यू के बाद ही कॉल करता है; parse_reward_callback() से जांचें और वहीं रिवॉर्ड दें।

क्या मैं AdsGram से माइग्रेट कर सकता हूँ?

हाँ। API वही init({ blockId }).show() पैटर्न और वही इवेंट्स इस्तेमाल करता है, इसलिए आमतौर पर सिर्फ़ स्क्रिप्ट और ब्लॉक ID बदलते हैं।

अपने Telegram ट्रैफ़िक से कमाना शुरू करें

ब्लॉक बनाएं, पैकेज इंस्टॉल करें और आज ही पहले इम्प्रेशन देखें।

npm i adsun-sdk
pip install adsun

Want to try?

See real Adsun ads live in Telegram.