앱 오프닝 광고 형태 소개
앱 오프닝 광고는 다음과 같은 시점에 사용할 수 있는 전면 광고 형식입니다:- 앱 시작 시 로딩 화면에서 광고 표시
- 앱이 백그라운드에서 포그라운드로 전환될 때 광고 표시
광고 연동하기
1
adUnit 생성
대시보드에서 발급받은
ad unit ID를 사용하여 광고 단위를 설정합니다.val adUnit = DaroAppOpenAdUnit(
unitId = ${AdUnitId},,
placement = ${placement}, // 로그 상 보여질 이름입니다. 공백을 보내도 무관합니다.
)
2
DaroAppOpenAdManager 생성 및 광고 로드
앱 오프닝 광고요청을 위한 DaroAppOpenAdManager를 생성합니다.
// Application 클래스의 onCreate 시점에 해당 코드를 호출해주세요.
val appOpenAdManager = DaroAppOpenAdManager.Builder(application)
.setAdUnit(adUnit)
.setAppOpenAdLoaderListener(object : DaroAppOpenAdLoaderListener {
override fun onAdLoadSuccess(ad: DaroAppOpenAd, adInfo: DaroAdInfo) {
// 광고 로드 성공
}
override fun onAdLoadFail(error: DaroLoadError) {
// 광고 로드 실패
}
})
.setAppOpenAdListener(object : DaroAppOpenAdListener {
override fun onAdImpression(adInfo: DaroAdInfo) {
// 앱 오프닝 광고 임프레션 이벤트
}
override fun onAdClicked(adInfo: DaroAdInfo) {
// 앱 오프닝 광고 클릭 이벤트
}
override fun onShown(adInfo: DaroAdInfo) {
// 앱 오프닝 광고화면이 보여질때
}
override fun onDismiss(adInfo: DaroAdInfo) {
// 앱 오프닝 광고 화면이 닫혔을때
}
override fun onFailedToShow(adInfo: DaroAdInfo, error: DaroAdDisplayFailError) {
// 앱 오프닝 광고 화면을 보여주는데 실패했을때
}
})
.build()
// 광고 로드
appOpenAdManager.loadAd()
3
앱 오프닝 광고 표시
앱 오프닝 광고를 표시합니다.
// 1. Activity, Fragment, Composable 에서 직접 광고 호출이 필요하다면
appOpenAdManager.showIfAvailable(activity)
// 2. 앱이 background -> foreground 로 전환될때마다 호출이 필요하다면
// Application.ActivityLifecycleCallbacks를 구현해야 합니다.
class ActivityLifecycleCallbacks : Application.ActivityLifecycleCallbacks {
override fun onActivityStarted(activity: Activity) {
// (주의) 광고 표시 중 인지 체크해야 합니다.
if (!appOpenAdManager.isShowingAd()) {
appOpenAdManager.showIfAvailable(activity)
}
}
...
}
application.registerActivityLifecycleCallbacks(ActivityLifecycleCallbacks())
4
DaroAppOpenAdManager 리소스 정리
앱 오프닝 광고가 더 이상 필요하지 않을 때 리소스를 정리합니다.
appOpenAdManager.destroy()
콜드 스타트 시 DaroAppOpenAdManager 초기화
class MyApplication : Application() {
private lateinit var appOpenAdManager: DaroAppOpenAdManager
override fun onCreate() {
super.onCreate()
val adUnit = DaroAppOpenAdUnit(
unitId = "your_appopen_unit_id",
placement = "placement"
)
appOpenAdManager = DaroAppOpenAdManager.Builder(this)
.setAdUnit(adUnit)
.setAppOpenAdLoaderListener(...)
.setAppOpenAdListener(...)
.build()
appOpenAdManager.loadAd()
val callbacks = object : Application.ActivityLifecycleCallbacks {
override fun onActivityStarted(activity: Activity) {
if (appOpenAdManager.isShowingAd()) {
appOpenAdManager.showIfAvailable()
}
}
...
}
registerActivityLifecycleCallbacks(callbacks)
}
// 앱 오프닝 광고를 더이상 보여줄 필요가 없을때 호출
fun destroy() {
appOpenAdManager.destroy()
}
}