ドキュメント · 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)機能プロモーション
機能プロモーションは、まだロックを解除していないユーザーにアプリの機能を紹介するための、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) { }
})