Reward और Interstitial एकीकरण
आवश्यकताएँ
- Telegram mini app हो
- पता हो कि विज्ञापन कहाँ दिखाना है, यदि नहीं तो एकीकरण उदाहरण देखें
blockIdहो, यदि नहीं तो Get blockId अनुभाग देखें
स्थापना
आपके पास AdsGram SDK को एकीकृत करने के दो विकल्प हैं।
स्क्रिप्ट डालें
<head> टैग में sad.min.js स्क्रिप्ट रखें इस कोड के साथ:
<script src="https://sad.adsgram.ai/js/sad.min.js"></script>React और Vue के लिए npm के माध्यम से इंस्टॉल करें।
packages के लिए एकीकरण के बारे में अधिक जानकारी देखें React और Vue दस्तावेज़ में।
npm install @adsgram/reactnpm install @adsgram/vueAdsGram SDK प्रारंभ करें
const AdController = window.Adsgram.init({ blockId: "your-block-id" });महत्वपूर्ण
Rewarded और Interstitial प्रारूपों के लिए केवल initialization आवश्यक है। Task प्रारूप के लिए initialization की आवश्यकता नहीं होती।Task प्रारूप के लिए एकीकरण उदाहरणों के लिए, Task Integration देखें।
अधिक जानकारी init फ़ंक्शन के बारे में API संदर्भ में मिल सकती है。
your-block-id — आप इसे https://partner.adsgram.ai से प्राप्त करते हैं
BlockId प्राप्त करने के लिए विस्तृत निर्देश Get blockId अनुभाग में देखें
बैनर दिखाएँ
- Rewarded प्रारूप में, जिसका अर्थ है कि आपको उपयोगकर्ता को अंत तक देखने पर पुरस्कार देना चाहिए।
अधिक जानकारी विज्ञापन आवश्यकताएँ में देखें。 - Interstitial प्रारूप में, जिसका अर्थ है कि उपयोगकर्ता अंत से पहले विज्ञापन छोड़ सकता है।
अधिक जानकारी विज्ञापन आवश्यकताएँ में देखें।
जानकारी
नीचे Rewarded प्रारूप के लिए कोड उदाहरण दिए गए हैं। ये उदाहरण Interstitial प्रारूप के लिए भी लागू हैं। एकमात्र अंतर यह है कि AdController.show() प्रॉमिस उन विज्ञापनों के लिए भी resolve होता है जो पूरी तरह देखे गए हों और उन विज्ञापनों के लिए भी जो बंद किए गए हों। सरल उदाहरण आप यहाँ पा सकते हैं
अधिकांश मामलों में, नीचे दिया गया कोड क्लिक हैंडलर के अंदर उपयोग किया जाता है।
Vanilla js, React, Unity के कोड उदाहरणों के लिए कोड उदाहरण देखें。
AdController.show().then((result) => {
// उपयोगकर्ता विज्ञापन को अंत तक देखता है या interstitial प्रारूप में बंद करता है
// rewarded प्रारूप के लिए उपयोगकर्ता को reward देने का आपका कोड
}).catch((result) => {
// विज्ञापन चलाते समय error आया या दिखाने के लिए कोई बैनर नहीं
// कुछ न करें या जो आप चाहें
})AdController.show().then((result: ShowPromiseResult) => {
// उपयोगकर्ता विज्ञापन को अंत तक देखता है या interstitial प्रारूप में बंद करता है
// rewarded प्रारूप के लिए उपयोगकर्ता को reward देने का आपका कोड
}).catch((result: ShowPromiseResult) => {
// विज्ञापन चलाते समय error आया या विज्ञापन skip किया
// कुछ न करें या जो आप चाहें
})result के निम्नलिखित प्रकार हैं:
interface ShowPromiseResult {
done: boolean; // true यदि उपयोगकर्ता अंत तक देखे या interstitial प्रारूप में बंद करे, अन्यथा false
description: string; // event का विवरण
state: 'load' | 'render' | 'playing' | 'destroy'; // बैनर की स्थिति
error: boolean; // true यदि error के कारण event emit हुआ, अन्यथा false
}जानकारी
showPromise resolve हो जाता है यदि उपयोगकर्ता विज्ञापन को अंत तक देखता है या interstitial प्रारूप में बंद करता है, अन्यथा reject हो जाता है।
सुझाव
Promise को finally के साथ chain करें यदि आपको विज्ञापन चलने के बाद, skip किए जाने पर या error आने पर कोई अतिरिक्त action जोड़ना है।
बधाई हो, आपने अभी AdsGram का उपयोग करके अपना पहला विज्ञापन दिखाया!
अधिक जानकारी
- एकीकरण कोड उदाहरण React, Unity, vanilla js के लिए
- यदि एकीकरण में परेशानी हो तो समस्या निवारण देखें
- Advanced AdController api reference आप API संदर्भ में पा सकते हैं
- यदि आप Typescript उपयोग करते हैं तो Typescript अनुभाग देखें