Reward ve Interstitial Entegrasyonu
Gereksinimler
- bir Telegram mini uygulamasına sahip olun
- nerede reklam göstereceğinizi bilin, bilmiyorsanız Reklam entegrasyon örneklerine bakın
blockId'ye sahip olun, yoksa blockId alma bölümüne bakın
Kurulum
AdsGram SDK'sını entegre etmek için iki seçeneğiniz vardır.
Script Ekleme
sad.min.js scriptini <head> etiketi içine aşağıdaki kodla yerleştirin:
<script src="https://sad.adsgram.ai/js/sad.min.js"></script>React ve Vue için npm üzerinden kurulum.
Paketlerden entegrasyon hakkında daha fazla bilgi için React ve Vue dokümantasyonuna bakın.
npm install @adsgram/reactnpm install @adsgram/vueAdsGram SDK Başlatma
const AdController = window.Adsgram.init({ blockId: "your-block-id" });IMPORTANT
Başlatma yalnızca Reward ve Interstitial formatları için gereklidir. Task formatı için başlatma gerekli değildir.Task formatı entegrasyon örnekleri için Task Entegrasyonu bölümüne bakın.
init fonksiyonu hakkında daha fazla bilgiyi API Reference bölümünde bulabilirsiniz.
your-block-id — https://partner.adsgram.ai adresindeki hesabınızdan alırsınız
blockId nasıl alınacağına dair detaylı talimatları blockId alma bölümünde bulabilirsiniz.
Banner Gösterme
- Rewarded formatı, kullanıcının reklamı sonuna kadar izlediğinde kullanıcıya ödül vermeniz gerektiği anlamına gelir.
Reklam gösterme gereksinimleri hakkında daha fazla bilgi. - Interstitial formatı, kullanıcının reklamı sonundan önce atlayabileceği anlamına gelir.
Reklam gösterme gereksinimleri hakkında daha fazla bilgi.
INFO
Aşağıda Rewarded formatı için kod örnekleri bulunmaktadır. Bu örnekler Interstitial formatı için de geçerlidir. Tek fark, AdController.show() promise'inin sonuna kadar izlenen reklamların yanı sıra kapatılan reklamlar için de çözülmesidir. Basit örneğe buradan ulaşabilirsiniz.
Çoğu durumda, aşağıdaki kod tıklama işleyicisi içinde kullanılır.
Vanilla js, React, Unity için kod örneklerine Kod örnekleri bölümüne bakın.
AdController.show().then((result) => {
// kullanıcı reklamı sonuna kadar izler veya interstitial formatında kapatır
// rewarded formatı için kullanıcıyı ödüllendirme kodunuz
}).catch((result) => {
// kullanıcı reklam oynatma sırasında hata alır
// hiçbir şey yapmayın veya istediğinizi yapın
})AdController.show().then((result: ShowPromiseResult) => {
// kullanıcı reklamı sonuna kadar izler veya interstitial formatında kapatır
// rewarded formatı için kullanıcıyı ödüllendirme kodunuz
}).catch((result: ShowPromiseResult) => {
// kullanıcı reklam oynatma sırasında hata alır veya reklamı atlar
// hiçbir şey yapmayın veya istediğinizi yapın
})result aşağıdaki türlere sahiptir:
interface ShowPromiseResult {
done: boolean; // kullanıcı sonuna kadar izlerse veya interstitial formatında kapatırsa true, aksi halde false
description: string; // olay açıklaması
state: 'load' | 'render' | 'playing' | 'destroy'; // banner durumu
error: boolean; // olay hata nedeniyle yayımlandıysa true, aksi halde false
}INFO
showPromise, kullanıcı reklamı sonuna kadar izlerse veya interstitial formatında kapatırsa çözülür, aksi halde reddedilir.
TIP
Reklam oynatmayı bitirdikten, atlandıktan veya hata aldıktan sonra herhangi bir ek eylem eklemeniz gerekiyorsa promise'i finally ile zincirleyin.
Tebrikler, AdsGram kullanarak ilk reklamınızı gösterdiniz!
Daha Fazla Bilgi
- React, Unity, vanilla js için Kod entegrasyon örnekleri
- Entegrasyonla ilgili sorun yaşıyorsanız Sorun Giderme bölümüne bakın
- Gelişmiş AdController API referansını API Reference bölümünde bulabilirsiniz
- TypeScript kullanıyorsanız TypeScript bölümüne bakın