유저 편의 기능
Buzzvil SDK를 연동한 후 추가할 수 있는 유저 편의 기능을 구현하는 방법에 대해 알아보세요.
다크 테마(Dark theme) 설정
Buzzvil SDK는 앱의 테마 설정에 따라 자동으로 다크 테마가 적용됩니다.
앱에서 다크 테마 비활성화하기
Application의 onCreate에서 앱의 테마를 밝은 테마(Light theme)로 고정하세요.
✏️ 참고
버즈빌의 모든 SDK 제품과 앱 전체에 적용됩니다.
class MyApplication : Application {
override fun onCreate() {
super.onCreate()
// 아래 코드 추가
AppCompatDelegate.setDefaultNightMode(AppCompatDelegate.MODE_NIGHT_NO)
}
}
액션형 광고의 유저 문의 기능 추가하기
Buzzvil SDK는 동영상 시청, 앱 설치, 페이스북 페이지의 ‘좋아요’ 클릭 등 다양한 유저 액션에 리워드를 지급하는 액션형 광고를 제공합니다. 액션형 광고에 참여한 유저가 포인트 적립에 실패하는 경우, Buzzvil SDK에서는 문의(이하 VOC) 접수와 처리를 자동화하는 서비스를 제공합니다. VOC 기능을 추가하려면 다음의 절차를 따르세요.
- VOC 처리 페이지를 불러오기 위한 UI(아이콘 또는 탭)을 디자인하세요.
- 1번 단계에서 디자인한 UI를 클릭하면,
BuzzAdBenefit.getInstance().showInquiryPage(Context, YOUR_UNIT_ID)를 호출하세요.
- 이때,
YOUR_UNIT_ID인자는 필수로 설정해야 합니다.각 지면에 맞는 Unit ID 값을 사용하세요.
동영상 광고 재생 조건 변경하기
동영상 광고는 기본적으로 유저 기기가 Wi-Fi를 통해 인터넷에 연결되어 있을 때에만 자동 재생되도록 설정되어 있습니다. 동영상 광고를 자동으로 재생하는 조건은 다음 중 한 가지로 설정할 수 있습니다.
- 유저 기기가 Wi-Fi를 통해 인터넷에 연결되어 있을 때에만 자동 재생 (초기 설정 값)
- 유저 기기의 인터넷 연결 방식과 상관없이 항상 자동 재생
- 유저 기기의 인터넷 연결 방식과 상관없이 자동 재생하지 않음
다음의 예시를 참고하여 동영상 광고의 자동 재생 조건을 변경하세요.
val userPreferences = UserPreferences.Builder(BuzzAdBenefit.getUserPreferences())
.autoplayType(AutoplayType.ON_WIFI)
// .autoplayType(AutoplayType.DISABLED) // 동영상 광고를 자동으로 재생하지 않습니다.
// .autoplayType(AutoplayType.ENABLED) // 동영상 광고를 항상 자동재생합니다.
.build()
BuzzAdBenefit.setUserPreferences(userPreferences)
광고 타입 확인하기
베네핏허브 또는 네이티브 지면의 광고 타입을 알고 싶은 경우 NativeAd 또는 NativeAd2 에서 제공하는 함수를 통해 확인할 수 있습니다.
NativeAd 또는 NativeAd2 에서 광고 타입을 확인하는 함수는 다음과 같습니다.
| 함수 | 설명 | 리턴 값 |
|---|---|---|
NativeAd.revenueType 또는 NativeAd2.revenueType | revenueType을 string으로 반환합니다. |
|
다음은 베네핏허브 광고 디자인 커스터마이징 시 NativeAd 에서 광고 타입을 확인하는 예제입니다.
class CustomBenefitHubAdViewAdapter : BenefitHubAdViewAdapter {
override fun getNativeAdView(): NativeAdView {}
override fun onBindView(nativeAd: NativeAd) {
val revenueType = nativeAd.revenueType
if (revenueType == "cpa") {
// 액션형 광고일 때 동작
}
}
override fun onCreateView(context: Context, parent: ViewGroup): View {}
override fun onDestroyView() {}
}
다음은 네이티브 연동 시 NativeAd2 에서 광고 타입을 확인하는 예제입니다.
nativeAd2ViewBinder.addNativeAd2StateChangedListener(object : NativeAd2StateChangedListener {
override fun onComplete() {}
override fun onError(adError: AdError) {}
override fun onNext(nativeAd2: NativeAd2) {
val revenueType = nativeAd.revenueType
if (revenueType == "cpa") {
// 액션형 광고일 때 동작
}
}
override fun onRequested() {}
})