통합 가이드

Buzzvil SDK 연동 가이드

# 소개

이 문서는 모바일 앱에 Buzzvil SDK를 연동해 리워드형 광고 인벤토리를 노출하려는 클라이언트 개발자를 위한 가이드입니다. 의존성 추가부터 초기화, 광고 배치, 콜백 검증까지 한 번에 따라갈 수 있도록 구성했습니다.

SDK는 최소 의존성으로 설계되어 있어 기존 빌드에 미치는 영향이 적습니다. 전체 연동은 보통 30분 이내에 끝납니다.

• 최소 지원 버전: Android 8.0(API 26), iOS 14 이상
• 네트워크 권한과 인터넷 접근이 필요합니다
• BuzzvilSdk.init()

# 설치 및 설정

패키지 매니저로 SDK를 추가한 뒤, 앱 시작 시점에 한 번만 초기화하면 됩니다. 초기화에는 콘솔의 프로젝트 설정에서 발급받은 앱 키가 필요하며, 환경별로 분리해 관리하는 것을 권장합니다.

1. SDK 의존성 추가

   패키지 매니저에 Buzzvil SDK를 추가하고 의존성을 동기화하세요. 버전은 릴리스 노트에 고정된 최신 안정 버전을 사용하는 것을 권장합니다.

2. 앱 키로 초기화

   BuzzvilSdk.init()

3. 광고 유닛 배치

   화면에 광고 뷰를 추가하고 발급받은 유닛 ID를 연결하세요. 레이아웃에 맞는 광고 포맷을 선택하면 됩니다.

4. 콜백으로 검증

   로드 성공·실패 콜백과 리워드 콜백을 연결해 동작을 확인하세요. 테스트 모드에서 더미 광고로 흐름을 먼저 검증하는 것을 권장합니다.

앱 시작 시점에 SDK를 초기화하는 예시입니다.

import com.buzzvil.sdk.BuzzvilSdk

class App : Application() {
  override fun onCreate() {
    super.onCreate()
    // app key is injected from build config, never hardcoded
    BuzzvilSdk.init(this, BuildConfig.BUZZVIL_APP_KEY) { result ->
      if (result.isSuccess) Log.d("Buzzvil", "init ok")
      else Log.e("Buzzvil", "init failed: ${result.error}")
    }
  }
}

앱 키를 소스 코드에 하드코딩하지 마세요. 빌드 설정이나 보안 저장소를 통해 주입하는 것이 안전합니다.

# 기본 사용법

초기화가 끝나면 광고 유닛을 화면에 배치하고 콜백을 연결합니다. 리워드 콜백에서 적립 금액을 받아 앱의 포인트 시스템에 반영하면 기본 연동이 완성됩니다.

유닛 ID로 광고를 로드하고 리워드를 처리하는 예시입니다.

val ad = BuzzvilSdk.loadAd(
  unitId = BuildConfig.BUZZVIL_UNIT_ID,
  userId = session.userId,        // empty allowed for anonymous
  format = AdFormat.NATIVE,
  testMode = BuildConfig.DEBUG,   // dummy ads off in release
)

ad.onReward { amount -> points.credit(amount) }
ad.onAdFailedToLoad { error -> showFallback(error.code) }

파라미터와 콜백의 전체 목록은 레퍼런스 탭을 참고하세요.