Documentación · Integración en Android

6. Llamadas a los formatos de anuncios

Cada llamada de anuncio recibe un placeholder: una clave de tipo cadena asociada a un formato de anuncio en el portal de AKS (p. ej., "1"). En tiempo de ejecución, AKS resuelve el placeholder para determinar una red publicitaria principal y una lista de redes alternativas; nunca se hace referencia directamente a un ID de unidad de anuncio en el código.

Intersticial

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)

Recompensado

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)

Apertura de la aplicación

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)

Si prefieres usar la gestión integrada de AKS para los anuncios de la pantalla de inicio y de apertura de la aplicación (controlada por el indicador de configuración remota isAppOpenAtApplicationLvl) en lugar de gestionar los anuncios de apertura por tu cuenta, usa loadDefaultAppOpen / showDefaultAppOpen en tu subclase de AppsKitSDKApplication, o simplemente llama a requestSplashAppOpenAd(callbacks, addInDefaultDelay), que la clase base Application ya implementa de principio a fin.

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).

Nativo

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)

Promoción de funcionalidades

La promoción de funcionalidades es el formato de anuncios de autopromoción de AKS para promocionar una funcionalidad de tu aplicación entre los usuarios que aún no la han desbloqueado. Solo se sirve a través de la red AKS (no de AdMob/MAX/etc.), y los elementos promocionados se configuran en el servidor desde el portal de AKS, asociados al placeholder.

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. Inicialización del SDK y AdsManager 7. Eventos y logs de AKS →