ドキュメント · AppsKitSDK (AKS) — Android 組み込みガイド

6. 広告フォーマットの呼び出し

すべての広告呼び出しには、プレースホルダーを渡します。これは、AKS ポータルで広告フォーマットに紐づけて設定する文字列キーです（例："1"）。AKS は実行時に、プレースホルダーから優先する広告ネットワークとフェイルオーバー先のリストを解決します。コード内で広告ユニット ID を直接指定する必要はありません。

インタースティシャル広告

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)

リワード広告

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)

アプリ起動広告

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)

アプリ起動広告を自分で管理する代わりに、AKS 標準のスプラッシュ画面／アプリ起動広告の処理（リモート設定フラグ isAppOpenAtApplicationLvl で制御）を使用する場合は、AppsKitSDKApplication サブクラスで loadDefaultAppOpen / showDefaultAppOpen を使用してください。または、requestSplashAppOpenAd(callbacks, addInDefaultDelay) を呼び出すだけでも構いません。このメソッドには、基底の Application クラスで一連の処理が実装されています。

バナー広告

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

ネイティブ広告

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)

// Show the native ad using the design you created for this placeholder in the
// AKS portal, instead of a layout resource — see below.
AdsManager.showTemplatedNative(activity, frameLayout, placeholder, isShowInScrollView = false, callback)

showTemplatedNative は、アプリのコード内ではなく、AKS ポータル上でネイティブ広告のデザインを作成して割り当てたプレースホルダー向けのメソッドです。アプリ側でレイアウトを指定しないため、res パラメーターはありません。AKS は、このプレースホルダーに適用されるポータルのテンプレートを特定して取得し（初回取得後はキャッシュ）、showNative と同じ読み込み・表示処理を通じて、そのテンプレートでネイティブ広告を描画します。プレースホルダーにテンプレートが割り当てられていない場合や、テンプレートを取得できない場合は、広告表示を失敗させるのではなく、AKS 組み込みのデフォルトのネイティブ広告デザインにフォールバックします。そのため、ポータル側でテンプレートを設定する前でも、安心して呼び出せます。

機能プロモーション

機能プロモーションは、アプリ内の機能をまだアンロックしていないユーザーに、その機能を紹介するための AKS 独自の自社広告フォーマットです。AKS ネットワークでのみ配信され（AdMob/MAX などは使用しません）、プロモーション対象の項目は、AKS ポータルのサーバー側設定でプレースホルダーごとに設定します。

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 と AdsManager の初期化 7. AKS のイベントとログ →