Apps Kit SDK logoApps Kit SDK
Dokümantasyon · Android Entegrasyonu

6. Reklam formatlarını çağırma

Her reklam çağrısı bir placeholder alır. Bu, AKS portalında bir reklam formatıyla eşleştirilen bir dize anahtarıdır (ör. "1"). AKS, çalışma zamanında placeholder'ı birincil reklam ağı ve hata durumunda kullanılacak yedek ağ listesiyle eşleştirir; kodda hiçbir zaman doğrudan bir reklam birimi kimliği kullanmazsınız.

Geçiş Reklamı (Interstitial)

kotlin
// Load only
AdsManager.loadInterstitial(context, placeholder, object : AdsCallback() {
    override fun onLoaded() { }
    override fun onFailedToLoad() { }
    override fun onAdShown() { }
    override fun onAdDismissed() { }
    override fun onAdFailedToShow() { }
})

// Show a previously loaded interstitial
AdsManager.showInterstitial(activity, placeholder, callback)

// Load and show in one call
AdsManager.loadAndShowInterstitialAd(activity, placeholder, callback)

// Check availability before showing
AdsManager.isInterstitialAvailable(placeholder)

Ödüllü Reklam (Rewarded)

kotlin
AdsManager.loadRewarded(context, placeholder, object : RewardedAdCallbacks() {
    override fun onRewardedLoaded() { }
    override fun onRewardedAdLoadFailure() { }
    override fun onRewardedCompleted() { }
    override fun onAdRewarded() { }
    override fun onAdRewardedAdDismissed() { }
    override fun onRewardedFailedToShow() { }
})

AdsManager.showRewarded(activity, placeholder, callbacks)

// Load and show in one call — simpler success/fail callback
AdsManager.loadAndShowRewardedAd(activity, placeholder, object : RewardedLoadAndShowCallback {
    override fun onRewardedAdSuccess() { }
    override fun onRewardedAdFailed() { }
})

AdsManager.isRewardedAvailable(placeholder)

Uygulama Açılış Reklamı (App Open)

kotlin
AdsManager.loadAppOpen(application, placeholder, object : AppOpenAdCallbacks() {
    override fun onLoaded() { }
    override fun onFailedToLoad() { }
    override fun onDismiss() { }
    override fun onAdShown() { }
    override fun onAdFailToShow() { }
})

AdsManager.showAppOpen(activity, placeholder, callbacks)

App Open reklamlarını kendiniz yönetmek yerine AKS'nin kendi açılış ekranı/uygulama açılış reklamı yönetimini (isAppOpenAtApplicationLvl uzaktan yapılandırma bayrağıyla kontrol edilir) kullanmak istiyorsanız, AppsKitSDKApplication alt sınıfınızda loadDefaultAppOpen / showDefaultAppOpen metotlarını kullanın. Alternatif olarak, temel Application sınıfının uçtan uca zaten uyguladığı requestSplashAppOpenAd(callbacks, addInDefaultDelay) metodunu çağırmanız yeterlidir.

kotlin
AdsManager.loadBanner(context, placeholder, object : BannerCallback() {
    override fun onBannerLoaded() { }
    override fun onBannerFailedToLoad() { }
    override fun onBannerClicked() { }
    override fun onBannerShown() { }
    override fun onBannerSizeChanged(bannerSizes: BannerSizes) { }
    override fun setBannerSize(width: Double, height: Double) { }
})

// layout is a FrameLayout (BannerContainer) you've placed in your screen
AdsManager.showBanner(activity, layout, placeholder, callback)

BannerSizes: BANNER (320×50), LARGE_BANNER (320×100), MEDIUM_RECTANGLE (300×250), FULL_BANNER (468×60).

Yerel Reklam (Native)

kotlin
AdsManager.loadNative(activity, placeholder, isShowInScrollView = false, object : NativeCallback() {
    override fun onNativeLoaded() { }
    override fun onNativeFailedToLoad() { }
    override fun onNativeClicked() { }
    override fun onNativeShown() { }
})

// frameLayout is the BannerContainer that will host the native ad view; res is an
// optional custom native-ad layout resource (pass null to use AKS's default layout)
AdsManager.showNative(activity, frameLayout, placeholder, isShowInScrollView = false, res = null, callback)

Özellik Tanıtımı (Feature Promotion)

Özellik Tanıtımı, uygulamanızdaki bir özelliği henüz kullanıma açmamış kullanıcılara çapraz tanıtmak için AKS'nin sunduğu kendi reklam formatıdır. Yalnızca AKS ağı üzerinden çalışır (AdMob/MAX/vb. üzerinden değil). Tanıtılacak öğeler, AKS portalında sunucu tarafında, ilgili placeholder'a özel olarak yapılandırılır.

kotlin
// Optional — exclude features the user already has unlocked from being promoted
AdsManager.setFeaturesAvailable(listOf("premium_theme", "no_ads"))

AdsManager.showFeaturePromotion(activity, placeholder, object : OnFeaturePromotionClicked {
    override fun onFeaturePromotionClicked(targetScreen: String) {
        // user tapped the promotion — navigate them to targetScreen
    }

    override fun onFailToShowFeaturePromotion(errorMessage: String) { }
})
← 5. SDK ve AdsManager'ı Başlatma7. AKS Olayları ve Logları →