마이그레이션 v5 → v6

여기에서는 BuzzAd Android SDK v5 에서 Buzzvil Android SDK v6 로 마이그레이션하기 위한 설정을 안내합니다.

GitHub 샘플 코드를 통해 실제 구현에 사용된 예제를 확인하세요.

✏️  참고
이 가이드는 v5, v6 최신 기준으로 작성되었습니다.

✅  중요
Buzzvil SDK 5점대부터는 계약 구조가 변경되었습니다. BuzzAd SDK 3점대 및 BuzzScreen SDK 4점대에서 Buzzvil SDK 6점대로 마이그레이션하는 경우, 계약서 갱신에 대해 반드시 버즈빌 담당 매니저 혹은 팀메일(partnership@buzzvil.com)로 문의 부탁드립니다.

시작하기

요구 사양

변경 사항이 없습니다.

연동용 ID 발급받기

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 더 이상 Feed Unit ID와 Pop Unit ID를 연동 코드에서 직접 사용하지 않습니다.

App ID와 Native Unit ID, Interstitial Unit ID는 기존과 동일하게 사용하실 수 있습니다.

포인트 적립 서버 연동하기

럭키박스, 미션팩이 추가되므로 포스트백 연동 가이드의 안내에 따라 요청 파라미터 처리가 필요합니다.

SDK 설치하기

buzzvil-bom 버전을 최신 버전으로 변경하세요.

def buzzvilBomVersion = 6.0.+

implementation platform("com.buzzvil:buzzvil-bom:$buzzvilBomVersion")

SDK 초기화하기

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 관련 설정 또한 FeedConfig 대신 버즈빌 대시보드(Dashboard)에서 설정하도록 변경되었습니다.

• BuzzAdBenefitConfig의 이름과 패키지 경로가 변경되었습니다.
• FeedConfig가 삭제되었습니다.

  import android.app.Application
- import com.buzzvil.buzzad.benefit.BuzzAdBenefitConfig
+ import com.buzzvil.buzzbenefit.BuzzBenefitConfig
  import com.buzzvil.sdk.BuzzvilSdk

  class App : Application() {
      override fun onCreate() {
          super.onCreate()

-         // Feed(베네핏허브) 설정
-         val feedConfig = FeedConfig.Builder("YOUR_FEED_UNIT_ID")
-             .build()

          // BuzzBenefit 설정
-         val buzzAdBenefitConfig = BuzzAdBenefitConfig.Builder("YOUR_APP_ID")
-             .setDefaultFeedConfig(feedConfig)
-             .build()
+         val buzzBenefitConfig = BuzzBenefitConfig.Builder("YOUR_APP_ID")
+             .build()

          // Buzzvil SDK 초기화
          BuzzvilSdk.initialize(
              application = this@App,
-             buzzAdBenefitConfig = buzzAdBenefitConfig
+             buzzBenefitConfig = buzzBenefitConfig
          )
      }
  }

유저 프로필 등록하기 (로그인 요청하기)

• UserProfile, BuzzvilSetUserProfileListener의 이름과 패키지 경로가 변경되었습니다.
• BuzzvilSdk.setUserProfile() 대신 BuzzvilSdk.login(), BuzzvilSdk.logout()을 사용하도록 변경되었습니다.
• 로그인 상태를 확인할 수 있는 BuzzvilSdk.isLoggedIn 프로퍼티가 새롭게 추가되었습니다.

  import com.buzzvil.sdk.BuzzvilSdk
- import com.buzzvil.sdk.BuzzvilSetUserProfileListener
+ import com.buzzvil.sdk.BuzzvilSdkLoginListener
- import com.buzzvil.buzzad.benefit.core.models.UserProfile
+ import com.buzzvil.sdk.BuzzvilSdkUser
  
+ // 유저 정보를 구성합니다.
+ val buzzvilSdkUser = BuzzvilSdkUser(
+     userId = "YOUR_USER_ID",
+     gender = BuzzvilSdkUser.Gender.MALE,
+     birthYear = 1980,
+ )

- // 유저 정보를 등록합니다.
- BuzzvilSdk.setUserProfile(
+ // 유저 정보로 로그인을 요청합니다.
+ BuzzvilSdk.login(
-     userId = "SAMPLE_USER_ID",
-     gender = UserProfile.Gender.MALE,
-     birthYear = 1980,
+     buzzvilSdkUser = buzzvilSdkUser,
      // (선택) 로그인 상태를 확인할 수 있는 리스너를 등록합니다.
-     listener = object : BuzzvilSetUserProfileListener {
-         override fun loggedIn() {
-             // 유저 정보가 정상적으로 등록된 경우 호출됩니다.
-         }
- 
-         override fun loggedOut() {
-             // 유저 정보를 삭제하는 경우 호출됩니다.
-         }
- 
-         override fun onSessionReady() {
-             // loggedIn() 이후에 버즈빌 서버에서 auth token을 정상적으로 받아오면   호출됩니다.
-             // onSessionReady가 호출된 이후부터 광고 할당이 가능합니다.
-         }
- 
-         override fun onFailure(errorType: BuzzvilSetUserProfileListener.ErrorType) {
-             // 유저 정보를 정상적으로 등록하지 못한 경우 호출됩니다.
-         }
-     }
+     listener = object : BuzzvilSdkLoginListener {
+         override fun onSuccess() {
+             // 로그인에 성공한 경우 호출됩니다.
+             // `BuzzvilSdk.isLoggedIn`이 true 상태가 됩니다.
+             // onSuccess가 호출된 이후부터 광고 할당이 가능합니다.
+         }
+  
+         override fun onFailure(errorType: BuzzvilSdkLoginListener.ErrorType) {
+             // 로그인에 실패한 경우 호출됩니다.
+             // NOT_INITIALIZED: SDK 초기화를 하지 않고 로그인을 시도한 경우
+             // INVALID_USER_ID: 적절하지 않은 값을 입력한 경우 (e.g. userId가 빈 문자열인 경우)
+             // UNKNOWN: 그 외 알 수 없는 오류
+         }
+     }
  )

+ // 로그인 상태를 확인합니다.
+ val isLoggedIn: Boolean = BuzzvilSdk.isLoggedIn

- // 유저 정보를 삭제합니다.
- BuzzvilSdk.setUserProfile(null)
+ // 로그아웃을 호출하면 로컬에 저장된 모든 유저 정보가 삭제됩니다.
+ BuzzvilSdk.logout()

앱 충돌 정보 수집 기능 사용하기

Buzzvil SDK에서 더 이상 Sentry를 사용하지 않습니다.

베네핏허브(BenefitHub)

연동

1 단계. 준비하기

Feed(베네핏허브)가 웹 베네핏허브로 변경되어 Feed Unid ID를 더 이상 연동 코드에서 사용하지 않습니다.

2 단계. 베네핏허브 초기화하기

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 관련 설정 또한 FeedConfig 대신 버즈빌 대시보드(Dashboard)에서 설정하도록 변경되었습니다.

3 단계. 베네핏허브 표시하기

• BuzzAdFeed의 이름과 패키지 경로가 변경되었습니다.
• show() 메서드가 객체 인스턴스 생성 없이 바로 호출하는 방식으로 변경되었습니다.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
+ import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHub
  
- val buzzAdFeed = BuzzAdFeed.Builder().build() 
- buzzAdFeed.show(activity)
+ BuzzBenefitHub.show(context)

기본 설정

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 관련 설정 또한 버즈빌 대시보드(Dashboard)에서 설정하도록 변경되었습니다.

럭키박스, 미션팩, 적립 내역, 광고 유형별 섹션 등 자세한 내용은 베네핏허브에서 확인하세요.

앱 UI에 진입 경로 구현

1. FeedEntryView가 삭제되었습니다.

FeedEntryView를 FrameLayout으로 대체하고 클릭 리스너를 추가하여 베네핏허브 진입을 구현하세요.

- <com.buzzvil.buzzad.benefit.presentation.feed.entrypoint.FeedEntryView
+ <FrameLayout
+     android:id="+@id/yourEntryPoint"
      android:layout_width="wrap_content"
      android:layout_height="wrap_content">
  
      <!-- 여기에 UI를 자유롭게 구현합니다. -->
      <ImageView
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:src="@drawable/your_image" />
-  </com.buzzvil.buzzad.benefit.presentation.feed.entrypoint.FeedEntryView>
+  </FrameLayout>

+ // 베네핏허브 진입점에 클릭 리스너를 추가하세요.
+ binding.yourEntryPoint.setOnClickListener {
+     BuzzBenefitHub.show(context)
+ }

2. Feed(베네핏허브)가 웹 베네핏허브로 변경되어 프리로드(preload) 및 적립 가능한 포인트 표시 기능이 삭제되었습니다.

- import com.buzzvil.buzzad.benefit.core.ad.AdError
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- 
- buzzAdFeed.load(object : BuzzAdFeed.FeedLoadListener {
-     override fun onSuccess() {
-         val availableReward = buzzAdFeed.getAvailableRewards()
-         // 적립 가능한 포인트를 직접 구현한 UI에 업데이트합니다.
-     }
- 
-     override fun onError(error: AdError?) {
-         // 적립 가능한 포인트를 가져올 수 없는 경우
-     }
- })

추가 구현

광고 타입 확인하기

Feed(베네핏허브)가 웹 베네핏허브로 변경되어 광고 타입 확인 기능을 제공하지 않습니다.

프래그먼트로 베네핏허브 연동하기

• BuzzAdFeed 객체 인스턴스 생성 없이 BuzzBenefitHubFragment를 생성할 수 있도록 변경되었습니다.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
+ import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHub

  class YourBenefitHubActivity : Activity() {
      override fun onCreate(savedInstanceState: Bundle?) {
          super.onCreate(savedInstanceState)
          setContentView(R.layout.activity_your_benefit_hub)
  
          if (savedInstanceState == null) {
-             val buzzAdFeed = BuzzAdFeed.Builder().build()
-             val benefitHubFragment = buzzAdFeed.getBenefitHubFragment()
+             // SDK를 초기화 하지 않은 경우 null이 반환됩니다.
+             val buzzBenefitHubFragment: BuzzBenefitHubFragment? = BuzzBenefitHubFragment.newInstance()

+             if (buzzBenefitHubFragment != null) {
                  supportFragmentManager.beginTransaction().apply {
                      add(R.id.yourFragmentContainer, buzzBenefitHubFragment)
                      commit()
                  }
+             } else {
+                 // 적절한 예외 처리를 추가하세요.
+             }
          }
      }
  }

광고 재할당 받기

Feed(베네핏허브)가 웹 베네핏허브로 변경되어 광고 재할당 기능이 삭제되었습니다.

- import com.buzzvil.buzzad.benefit.core.ad.AdError
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- 
- buzzAdFeed.load(object : BuzzAdFeed.FeedLoadListener {
-     override fun onSuccess() {
-         // 광고 재할당에 성공한 경우 호출됩니다.
-     }
-     override fun onError(error: AdError?) {
-         // 광고 재할당에 실패한 경우 호출됩니다.
-     }
- })

베네핏허브 표시 화면 변경하기

🆕 Feed(베네핏허브)가 웹 베네핏허브로 변경되어 특정 페이지를 바로 여는 기능이 공식적으로 추가되었습니다.

1. 베네핏허브를 표시하면서 필터 선택하기 기능이 삭제되었습니다.

- import com.buzzvil.buzzad.benefit.presentation.feed.FeedConfig
- 
- // Feed(베네핏허브) 설정
- val feedConfig = FeedConfig.Builder("YOUR_FEED_UNIT_ID")
-     .initialSelectedFilterName("쇼핑적립")
-     .build()

2. 럭키박스, 미션팩을 바로 표시하는 방식이 변경되었습니다.

- import com.buzzvil.buzzad.benefit.annotation.BuzzExperimentalApi
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.FeedConfig
- import com.buzzvil.buzzad.benefit.presentation.feed.FeedInitialNavigationPage
- 
- @OptIn(BuzzExperimentalApi::class) // 실험 기능을 사용하기 위한 어노테이션
- private fun getCustomBuzzAdFeed(): BuzzAdFeed {
-     if (customBuzzAdFeed == null) {
-         val feedConfig = FeedConfig.Builder(Constant.YOUR_FEED_UNIT_ID)
-             .initialNavigationPage(FeedInitialNavigationPage.LUCKYBOX) // (실험 기능) 초기 페이지 선택하기
-             .build()
- 
-         // 하나의 피드에 하나의 buzzAdFeed 인스턴스를 생성하여 사용합니다.
-         customBuzzAdFeed = BuzzAdFeed.Builder()
-             .feedConfig(feedConfig)
-             .build()
-     }
- 
-     return customBuzzAdFeed!!
- }

+ import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHub
+ import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHubConfig
+ import com.buzzvil.buzzbenefit.benefithub.BuzzBenefitHubRoutePath
+ 
+ val benefitHubConfig = BuzzBenefitHubConfig.Builder()
+     .routePath(BuzzBenefitHubRoutePath.LUCKY_BOX) // 초기 페이지 선택하기
+     .build()
+ BuzzBenefitHub.show(context = requireContext(), benefitHubConfig = benefitHubConfig)

네이티브

1 단계. 준비하기

변경 사항이 없습니다.

2 단계. 광고 레이아웃 구성하기

• MediaView, DefaultCtaView, NativeAd2View의 이름과 패키지 경로가 변경되었습니다.
• DefaultCtaView가 리워드 아이콘을 사용하지 않는 디자인으로 변경되었습니다.
• NativeToFeedLayout이 삭제되었습니다.

- <com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2View
+ <com.buzzvil.buzzbenefit.buzznative.BuzzNativeAdView
      android:id="@+id/nativeAd2View">
  
-     <com.buzzvil.buzzad.benefit.presentation.media.MediaView
+     <com.buzzvil.buzzbenefit.buzznative.BuzzMediaView
          android:id="@+id/mediaView"
          ...
  
-     <com.buzzvil.buzzad.benefit.presentation.media.DefaultCtaView
+     <com.buzzvil.buzzbenefit.DefaultBuzzCtaView
          android:id="@+id/ctaView"
          ...
  
-     <com.buzzvil.buzzad.benefit.presentation.feed.navigation.NativeToFeedLayout
+     <View
          android:id="@+id/yourNativeToBenefitHubEntryPoint">
          <!-- 여기에 자유롭게 베네핏허브 진입점을 구성할 수 있습니다. -->
          ...
-     </com.buzzvil.buzzad.benefit.presentation.feed.navigation.NativeToFeedLayout>
+     </View>
- </com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2View>
+ </com.buzzvil.buzzbenefit.buzznative.BuzzNativeAdView>

+ // 베네핏허브 진입점에 클릭 리스너를 추가하세요.
+ binding.yourNativeToBenefitHubEntryPoint.setOnClickListener {
+     BuzzBenefitHub.show(context)
+ }

베이스 리워드 금액 표시하기

Feed(베네핏허브)가 웹 베네핏허브로 변경되어 베이스 리워드 금액 표시하기 기능을 더 이상 제공하지 않습니다.

- import com.buzzvil.buzzad.benefit.BaseRewardManager
- import com.buzzvil.buzzad.benefit.BuzzAdBenefit
- 
- BuzzAdBenefit.getBaseRewardManager()?.getAvailableFeedBaseReward(YOUR_FEED_ID, object : BaseRewardManager.BaseRewardListener {
-     override fun onBaseRewardLoaded(reward: Int) {
-         if (reward < 1) {
-             nativeToFeedText.text = "더 많은 참여 기회 보기"
-         } else {
-             nativeToFeedText.text = "$reward 포인트 받고 더 많은 참여 기회 보기"
-         }
-     }
- })

3 단계. 광고 보여주기

- import com.buzzvil.buzzad.benefit.core.ad.AdError
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2StateChangedListener
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2ViewBinder
+ import com.buzzvil.buzzbenefit.BuzzAdError
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNative
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAd
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeRefreshEventsListener
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeViewBinder

  // 광고 레이아웃을 설정합니다.
- val binder: NativeAd2ViewBinder = NativeAd2ViewBinder.Builder()
+ val binder: BuzzNativeViewBinder = BuzzNativeViewBinder.Builder()
      .nativeAd2View(nativeAd2View)
      .mediaView(mediaView)
      .titleTextView(titleTextView)
      .descriptionTextView(descriptionTextView)
      .iconImageView(iconImageView)
      .ctaView(ctaView)
      .build(Constant.YOUR_NATIVE_ID)

+ // BuzzNative 객체를 생성합니다.
+ val buzzNative = BuzzNative(Constant.YOUR_NATIVE_ID)

  // (Optional) 광고 요청 상태에 따른 UI를 구현합니다.
- binder.addNativeAd2StateChangedListener(object : NativeAd2StateChangedListener {
+ buzzNative.setRefreshEventsListener(object : BuzzNativeRefreshEventsListener {
-     override fun onRequested() { ... }
+     override fun onRequest() { ... }

-     override fun onNext(nativeAd2: NativeAd2) { ... }
+     override fun onSuccess(buzzNativeAd: BuzzNativeAd) { ... }

-     override fun onComplete() { ... }
+     override fun onFailure(adError: BuzzAdError) { ... }

-     override fun onError(adError: AdError) { ... }
+     // 최초 광고 할당 성공, 실패 여부는 `BuzzNative.load(onSuccess, onFailure)` 에서 확인하세요.
  })

- // 광고 할당 및 표시를 자동으로 수행합니다.
- binder.bind()
+ // BuzzNative에서 광고를 할당받습니다.
+ buzzNative.load(
+     onSuccess = { nativeAd -> ... },
+     onFailure = { adError -> ... }
+ )
+
+ // 할당받은 광고를 화면에 표시합니다.
+ binder.bind(buzzNative)

추가 구현

광고 이벤트 리스너 등록하기

• NativeAd2, NativeAd2EventListener, NativeAd2ViewBinder, RewardResult의 이름과 패키지 경로가 변경되었습니다.
• RewardResult(BuzzRewardResult)의 일부 열거 값의 이름이 iOS와 동일하게 변경되었습니다. 자세한 변경 사항은 하단 RewardResult 변경 사항 항목을 확인하세요.
• 광고 이벤트 리스너 등록이 BuzzNative를 사용하도록 변경되었습니다.
• NativeAd2ViewBinder.addNativeAd2EventListener()가 삭제되고, BuzzNative.setAdEventsListener()를 통해 한 개의 리스너만 등록할 수 있도록 변경되었습니다.

- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2EventListener
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2ViewBinder
- import com.buzzvil.buzzad.benefit.presentation.reward.RewardResult
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAdEventsListener
+ import com.buzzvil.buzzbenefit.buzznative.BuzzRewardResult
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNative
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAd
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeViewBinder

- val binder: NativeAd2ViewBinder = NativeAd2ViewBinder.Builder() ...
+ val binder: BuzzNativeViewBinder = BuzzNativeViewBinder.Builder() ...

+ // BuzzNative 객체를 생성합니다.
+ val buzzNative = BuzzNative(Constant.YOUR_NATIVE_ID)

  // (Optional) 광고 이벤트 리스너를 등록합니다.
  // 로그 기록, 단순 알림 외에 다른 동작을 추가하는 것을 권장하지 않습니다. 직접 구현한 동작이 네이티브에서 제공하는 기능(광고 자동 갱신 등)과 충돌할 수 있습니다.
- binder.addNativeAd2EventListener(object : NativeAd2EventListener {
+ buzzNative.setAdEventsListener(object : BuzzNativeAdEventsListener {
-     override fun onImpressed(nativeAd2: NativeAd2) {
+     override fun onImpressed(buzzNativeAd: BuzzNativeAd) {
        // Native 광고가 유저에게 노출되었을 때 호출됩니다.
      }
  
-     override fun onClicked(nativeAd2: NativeAd2) {
+     override fun onClicked(buzzNativeAd: BuzzNativeAd) {
          // 유저가 Native 광고를 클릭했을 때 호출됩니다.
      }
  
-     override fun onRewardRequested(nativeAd2: NativeAd2) {
+     override fun onRewardRequested(buzzNativeAd: BuzzNativeAd) {
          // 리워드 적립을 요청했을 때 호출됩니다.
      }
  
-     override fun onParticipated(nativeAd2: NativeAd2) {
+     override fun onParticipated(buzzNativeAd: BuzzNativeAd) {
          // 유저가 광고 참여를 완료하였을 때 호출됩니다.
      }
  
-     override fun onRewarded(nativeAd2: NativeAd2, rewardResult: RewardResult) {
+     override fun onRewarded(buzzNativeAd: BuzzNativeAd, buzzRewardResult: BuzzRewardResult) {
          // 리워드가 적립되었을 때 호출됩니다.
+         // BuzzRewardResult의 변경된 열거 값을 확인하세요.
      }
  })
  
- binder.bind()
+ binder.bind(buzzNative)

RewardResult 변경 사항

RewardResult(BuzzRewardResult)의 일부 열거 값의 이름이 iOS와 동일하게 변경되었습니다. 자세한 변경 사항은 하단 BuzzRewardResult 변경 사항 항목을 확인하세요.

변경 전	변경 후
RewardResult	BuzzRewardResult
NETWORK_TIMEOUT	CONNECTION_TIMEOUT
NETWORK_TIMEOUT_IN_POWER_SAVE_MODE	CONNECTION_TIMEOUT_IN_POWER_SAVE_MODE
UNKNOWN_NETWORK_ERROR	NETWORK_ERROR
UNKNOWN_SERVER_ERROR	SERVER_ERROR
UNKNOWN_CLIENT_ERROR	CLIENT_ERROR
UNKNOWN_ERROR	UNKNOWN

클릭 가능 영역 추가하기

• 네이티브의 모든 영역이 클릭 가능 영역으로 바뀌어 NativeAd2ViewBinder.Builder.addClickableView()가 삭제되었습니다.

캐러셀 구현하기

✏️  참고
마이그레이션 가이드에서는 최종 형태의 캐러셀을 기준으로 변경 사항을 안내합니다.
캐러셀의 단계별 구현은 v6 캐러셀 구현하기에서 확인하세요.

1. 캐러셀 초기화

• 광고 중복 할당을 제어하는 클래스가 NativeAd2Pool에서 BuzzNativeGroup으로 바뀌었습니다.

- import com.buzzvil.buzzad.benefit.core.ad.AdError
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2Pool
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2PoolInitListener
+ import com.buzzvil.buzzbenefit.BuzzAdError
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeGroup

+ // 캐러셀 광고에서 광고 중복 할당을 방지하기 위한 BuzzNativeGroup 인스턴스입니다.
+ // Fragment의 생명 주기에 맞추어 생성 및 해제하세요.
+ private var buzzNativeGroup: BuzzNativeGroup? = null

-  private fun initCarouselPool() {
+  private fun initCarouselNativeGroup() {
      // 광고 중복 할당을 막기 위해 하나의 캐러셀에 하나의 BuzzNativeGroup 인스턴스를 생성하여 사용합니다.
-     val carouselPool = NativeAd2Pool(YOUR_NATIVE_UNIT_ID)
+     buzzNativeGroup = BuzzNativeGroup(YOUR_NATIVE_UNIT_ID)
      val REQUEST_AD_COUNT = 5

      // 현재 할당 받을 수 있는 광고의 갯수를 확인합니다.
-     carouselPool.init(REQUEST_AD_COUNT, object : NativeAd2PoolInitListener {
-         override fun onLoaded(adCount: Int) {
-             // TODO 할당 받은 광고 갯수(adCount)만큼 아이템 리스트를 만들어 RecyclerView 어댑터를 초기화 합니다.
-         }
- 
-         override fun onError(adError: AdError) {
-             // TODO 광고 레이아웃을 숨김 처리 하는 등 적절한 에러 처리를 할 수 있습니다.
-         }
-     })
+     buzzNativeGroup?.let {
+         it.load(
+             REQUEST_AD_COUNT,
+             onSuccess = { adCount ->
+                 // TODO 할당 받은 광고 갯수(adCount)만큼 아이템 리스트를 만들어 RecyclerView 어댑터를 초기화 합니다.
+             },
+             onFailure = { adError ->
+                 // TODO 광고 레이아웃을 숨김 처리 하는 등 적절한 에러 처리를 할 수 있습니다.
+             }
+         )
+     }
+ }
  
  override fun onDestroyView() {
      super.onDestroyView()

+     // BuzzNativeGroup의 리소스를 해제합니다.
+     buzzNativeGroup?.dispose()
  }

2. RecyclerView.Holder 구현

• NativeAd2ViewBinder 대신 BuzzNativeViewBinder를 사용하세요.
  • ViewHolder.init() 대신 ViewHolder.bind() 에서 리스너를 등록합니다.
• 베네핏허브 진입 슬라이드를 구성하기 위한 컴포넌트인 FeedPromotion, FeedPromotionFactory, FeedPromotionViewBinder가 삭제되었습니다.

- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2Pool
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2ViewBinder
- import com.buzzvil.buzzad.benefit.presentation.feed.entrypoint.FeedPromotion
- import com.buzzvil.buzzad.benefit.presentation.feed.entrypoint.FeedPromotionViewBinder
+ import com.buzzvil.buzzbenefit.BuzzAdError
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNative
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAd
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAdEventsListener
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeRefreshEventsListener
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeViewBinder
+ import com.buzzvil.buzzbenefit.buzznative.BuzzRewardResult
  
  class BuzzNativeCarouselViewHolder(
      private val binding: CarouselItemBinding,
  ) : RecyclerView.ViewHolder(binding.root) {
-     private val nativeAd2ViewBinder: NativeAd2ViewBinder
-     private val carouselToFeedViewBinder: FeedPromotionViewBinder
+     private var buzzNativeViewBinder: BuzzNativeViewBinder? = null
  
      init {
          // NativeView와 하위 컴포넌트를 바인드합니다.
-         nativeAd2ViewBinder = NativeAd2ViewBinder.Builder()
+         buzzNativeViewBinder = BuzzNativeViewBinder.Builder()
              .buzzNativeView(binding.buzzNativeView)
              .buzzMediaView(binding.buzzMediaView)
              .titleTextView(binding.adTitleText)
              .descriptionTextView(binding.adDescriptionText)
              .iconImageView(binding.adIconImage)
              .buzzCtaView(binding.adCtaView)
              .build()

-         // FeedPromotion 관련 클래스가 모두 삭제되었습니다.
-         carouselToFeedViewBinder = FeedPromotionViewBinder.Builder(nativeAd2View, mediaView)
-             ...

-         // bind() 에서 BuzzNativeRefreshEventsListener를 등록하는 것으로 대체되었습니다.
-         nativeAd2ViewBinder.addNativeAd2StateChangedListener(object : NativeAd2StateChangedListener {
-             override fun onComplete() {}
-             override fun onError(adError: AdError) {}
-             override fun onNext(nativeAd2: NativeAd2) {}
-             override fun onRequested() {}
-         })

-         // bind() 에서 BuzzNativeAdEventsListener를 등록하는 것으로 대체되었습니다.
-         nativeAd2ViewBinder.addNativeAd2EventListener(object : NativeAd2EventListener {
-             override fun onClicked(nativeAd2: NativeAd2) {}
-             override fun onImpressed(nativeAd2: NativeAd2) {}
-             override fun onParticipated(nativeAd2: NativeAd2) {}
-             override fun onRewardRequested(nativeAd2: NativeAd2) {}
-             override fun onRewarded(nativeAd2: NativeAd2, rewardResult: RewardResult) {}
-         })
      }

-     fun setPool(carouselPool: NativeAd2Pool, adKey: Int) {
-         nativeAd2ViewBinder.setPool(adKey, carouselPool)
-         carouselToFeedViewBinder.setPool(carouselPool)
-     }

-     fun bind(position: Int) {
      fun bind(native: BuzzNative, position: Int) {
+         // NativeAd2ViewBinder.addNativeAd2StateChangedListener() 대신 사용합니다.
+         native.setRefreshEventsListener(
+             object : BuzzNativeRefreshEventsListener {
+                 override fun onRequest() {}
+                 override fun onSuccess(buzzNativeAd: BuzzNativeAd) {}
+                 override fun onFailure(adError: BuzzAdError) {}
+             }
+         )
  
+         // NativeAd2ViewBinder.addNativeAd2EventListener() 대신 사용합니다.
+         native.setAdEventsListener(object : BuzzNativeAdEventsListener {
+             override fun onClicked(buzzNativeAd: BuzzNativeAd) {}
+             override fun onImpressed(buzzNativeAd: BuzzNativeAd) {}
+             override fun onParticipated(buzzNativeAd: BuzzNativeAd) {}
+             override fun onRewardRequested(buzzNativeAd: BuzzNativeAd) {}
+             override fun onRewarded(buzzNativeAd: BuzzNativeAd, buzzRewardResult: BuzzRewardResult) {}
+         })
  
          // BuzzNativeViewBinder.bind()를 호출하면 광고 할당 및 갱신이 자동으로 수행됩니다.
-         nativeAd2ViewBinder.bind(position)
          buzzNativeViewBinder?.bind(native)
      }
  
-     fun unbind(position: Int) {
+     fun unbind() {
          // unbind를 반드시 호출하여 뷰를 재사용할 때 문제가 발생하지 않게 합니다.
-         nativeAd2ViewBinder.unbind(position)
+         buzzNativeViewBinder?.unbind()
      }
  }

3. RecyclerView.Adapter 구현

• ViewHolder의 변경사항을 Adapter에도 적용합니다.

✏️  참고
FeedPromotion 관련 클래스가 삭제되며 캐러셀 예제 코드에서 NativeAd2CarouselItem도 함께 삭제되었습니다.
NativeAd2CarouselItem은 Buzzvil SDK에서 제공하는 클래스가 아니며, 캐러셀에 다양한 구성 요소를 넣을 수 있음을 보여주기 위한 예시입니다.
따라서 구현 여하에 따라 NativeAd2CarouselItem 또는 유사한 구현체를 계속 사용하실 수 있습니다.

- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2Pool
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNative
  
  class BuzzNativeCarouselAdapter(
-     private val list: List<NativeAd2CarouselItem>,
+     private val list: List<BuzzNative> // 구현 여하에 따라 List<NativeAd2CarouselItem>를 계속 사용하실 수도 있습니다.
-     private val carouselPool: NativeAd2Pool
- ) : RecyclerView.Adapter<NativeAd2CarouselViewHolder?>() {
+ ) : RecyclerView.Adapter<BuzzNativeCarouselViewHolder>() {
  
-     override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): NativeAd2CarouselViewHolder {
+     override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): BuzzNativeCarouselViewHolder {
          val inflater = parent.context.getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater
          val binding = BuzzNativeAdViewBinding.inflate(inflater, parent, false)

-         return NativeAd2CarouselViewHolder(binding)
+         return BuzzNativeCarouselViewHolder(binding)
      }
  
      override fun getItemCount(): Int {
          return list.size
      }
  
-     override fun onBindViewHolder(holder: NativeAd2CarouselViewHolder, position: Int) {
+     override fun onBindViewHolder(holder: BuzzNativeCarouselViewHolder, position: Int) {
-         holder.setPool(carouselPool, position)
+         val item = list[position]
+         holder.bind(item)
      }
  
-     override fun onViewRecycled(holder: NativeAd2CarouselViewHolder) {
+     override fun onViewRecycled(holder: BuzzNativeCarouselViewHolder) {
          super.onViewRecycled(holder)
  
          // unbind를 반드시 호출하여 뷰를 재사용할 때 문제가 발생하지 않게 합니다.
-         holder.unbind(holder.adapterPosition)
+         holder.unbind()
      }
  }

4. RecyclerView에 Adapter 적용

초기화 코드에 Adapter를 적용하세요.

- import com.buzzvil.buzzad.benefit.core.ad.AdError
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2Pool
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2PoolInitListener
+ import com.buzzvil.buzzbenefit.BuzzAdError
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNative
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeGroup

+ private var buzzNativeGroup: BuzzNativeGroup? = null

  // 캐러셀 초기화
- private fun initCarouselPool() { ... }
+ private fun initCarouselNativeGroup() { ... }
  
  // 초기화 코드에 Adapter를 적용하세요.
- private fun initCarouselAdapter(adCount: Int, carouselPool: NativeAd2Pool) {
+ private fun initCarouselAdapter(natives: List<BuzzNative>, adCount: Int) {
      // 할당 받은 광고 리스트로 BuzzNativeCarouselAdapter를 생성합니다.
-     val list: List<NativeAd2CarouselItem> = buildCarouselItems(adCount)
-     val adapter = NativeAd2CarouselAdapter(list, carouselPool)
+     val adapter = BuzzNativeCarouselAdapter(natives) // 구현 여하에 따라 List<NativeAd2CarouselItem>를 계속 사용하실 수도 있습니다.

      // RecyclerView에 어댑터를 설정합니다.
      binding.carouselRecyclerView.adapter = adapter
    }

  // 캐러셀 초기화
+ override fun onDestroyView() { ... }

캐러셀 베네핏허브 진입점

• FeedEntryView가 삭제되었습니다.

  <!-- 광고를 표시할 Carousel -->
  <androidx.recyclerview.widget.RecyclerView
      android:id="@+id/carouselRecyclerView"
      ... />
  
  <!-- Carousel 하단에 베네핏허브 진입점을 추가합니다. -->
- <com.buzzvil.buzzad.benefit.presentation.feed.entrypoint.FeedEntryView
-     android:id="@+id/toFeedLink"
-     android:layout_width="wrap_content"
-     android:layout_height="wrap_content"
-     android:layout_gravity="right"
-     android:layout_marginTop="16dp"
-     android:layout_marginEnd="36dp"
-     app:buzzvilFeedEntryViewName="carousel_to_feed_link">
- 
-     <!-- 내부 레이아웃은 자유롭게 설정할 수 있습니다. 아래는 LinearLayout으로 구현한 예시입니다. -->
+     <!-- 베네핏허브 진입점의 레이아웃은 자유롭게 설정할 수 있습니다. 아래는 LinearLayout으로 구현한 예시입니다. -->
      <LinearLayout
+         android:id="@+id/carouselToBenefitHubEntryView"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:orientation="horizontal">
  
          <TextView
              android:layout_width="wrap_content"
              android:layout_height="wrap_content"
              android:text="포인트 더 받으러 가기 >" />
      </LinearLayout>
- </com.buzzvil.buzzad.benefit.presentation.feed.entrypoint.FeedEntryView>

+ // 베네핏허브 진입점에 클릭 리스너를 추가하세요.
+ binding.carouselToBenefitHubEntryView.setOnClickListener {
+     BuzzBenefitHub.show(context)
+ }

인터스티셜(Interstitial)

BuzzAdInterstitial, InterstitialAdListener의 이름과 패키지 경로가 변경되었습니다.

- import com.buzzvil.buzzad.benefit.presentation.interstitial.BuzzAdInterstitial
+ import com.buzzvil.buzzbenefit.interstitial.BuzzInterstitial

- import com.buzzvil.buzzad.benefit.presentation.interstitial.InterstitialAdListener
+ import com.buzzvil.buzzbenefit.interstitial.BuzzInterstitialListener

팝(Pop)

기본형 팝

✅  중요
별도의 오버레이 화면으로 보이던 팝 베네핏허브가 일반 베네핏허브로 변경되었습니다.

변경 전(v5)	변경 후(v6)

1. 팝 초기화 코드가 삭제되었습니다.

• 더 이상 Pop Unit ID가 필요하지 않습니다.

- import com.buzzvil.buzzad.benefit.BuzzAdBenefitConfig
- import com.buzzvil.buzzad.benefit.presentation.feed.FeedConfig
- import com.buzzvil.buzzad.benefit.presentation.feed.config.OptInFeature
- import com.buzzvil.sdk.BuzzvilSdk
- 
- val popFeedConfig = FeedConfig.Builder("YOUR_POP_UNIT_ID")
-     .optInFeatureList(mutableListOf(OptInFeature.Pop))
-     .build()
- 
- val buzzAdBenefitConfig = BuzzAdBenefitConfig.Builder(context)
-     .setPopConfig(popFeedConfig)
-     .build()
-
- BuzzvilSdk.initialize(this@App, buzzAdBenefitConfig)

2. 팝 활성화/비활성화 코드가 간소화 되었습니다.

• BuzzAdPop의 이름과 패키지 경로가 변경되었습니다.

- import com.buzzvil.buzzad.benefit.pop.BuzzAdPop
+ import com.buzzvil.buzzbenefit.pop.BuzzPop
+ import com.buzzvil.buzzbenefit.pop.BuzzPopActivateListener
  
  // 팝 활성화
- BuzzAdPop.getInstance().activate(object: BuzzAdPop.PopActivateListener {
+ BuzzPop.activate(object : BuzzPopActivateListener {
      override fun onActivated() {
          // 정상적으로 Pop이 활성화 되었을 때 호출됩니다.

          // 유저 화면에 바로 Pop을 표시합니다.
-         BuzzAdPop.getInstance().show()
+         BuzzPop.show()
      }
  
-     override fun onActivationFailed(error: Throwable?) {
+     override fun onActivationFailed(error: Throwable) {
          // Pop 활성화에 실패하였을 때 호출됩니다.
      }
  })

  // 팝 비활성화
- BuzzAdPop.getInstance().deactivate(context)
+ BuzzPop.deactivate()

3. 팝 활성화 상태를 알 수 있는 프로퍼티가 추가되었습니다.

팝의 활성화 상태를 확인하려면 BuzzPop.isActivated를 사용하세요.

다음은 팝의 활성화 상태에 따라 팝을 켜고 끄는 예시입니다.

import com.buzzvil.buzzbenefit.pop.BuzzPop
import com.buzzvil.buzzbenefit.pop.BuzzPopActivateListener

fun togglePop() {
    if (BuzzPop.isActivated) {
        BuzzPop.deactivate()
    } else {
        BuzzPop.activate(object : BuzzPopActivateListener {
            override fun onActivated() {
                // 정상적으로 Pop이 활성화 되었을 때 호출됩니다.

                // 유저 화면에 Pop을 표시합니다.
                BuzzPop.show()
            }

            override fun onActivationFailed(error: Throwable) {
                // Pop 활성화에 실패하였을 때 호출됩니다.
            }
        })
    }
}

4. PopConfig 설정 방식이 변경되었습니다.

• PopConfig의 이름과 패키지 경로가 변경되었습니다.

- import com.buzzvil.buzzad.benefit.BuzzAdBenefitConfig
+ import com.buzzvil.buzzbenefit.BuzzBenefitConfig

- import com.buzzvil.buzzad.benefit.presentation.feed.FeedConfig
- import com.buzzvil.buzzad.benefit.pop.PopConfig
+ import com.buzzvil.buzzbenefit.pop.BuzzPopConfig
  
- val popFeedConfig = FeedConfig.Builder(Constant.YOUR_POP_ID)
-     .build()
- val popConfig = PopConfig.Builder(popFeedConfig)
+ val buzzPopConfig = BuzzPopConfig.Builder()
      .build()
  
- val buzzAdBenefitConfig = BuzzAdBenefitConfig.Builder(Constant.YOUR_APP_ID)
+ val buzzBenefitConfig = BuzzBenefitConfig.Builder("YOUR_APP_ID")
-     .setPopConfig(popConfig)
+     .setBuzzPopConfig(buzzPopConfig)
      .build()

팝 커스터마이징

별도의 오버레이 화면으로 보이던 팝 베네핏허브가 일반 베네핏허브로 변경되며 팝의 내비게이션 바, 유틸리티 영역, 커스텀 페이지, 팝 종료 아이콘 변경 기능이 삭제되었습니다. 관련 코드를 제거하세요.

내비게이션 바와 유틸리티 영역 기능이 삭제되었습니다.

커스텀 페이지(콘텐츠 영역) 기능이 삭제되었습니다.

BuzzAdPopTheme 설정 방식 변경

• BuzzAdPopTheme의 이름과 패키지 경로가 변경되었습니다.
• BuzzAdPopTheme의 객체 인스턴스 생성 없이 바로 호출하는 방식으로 변경되었습니다.

- import com.buzzvil.buzzad.benefit.pop.BuzzAdPop
- import com.buzzvil.buzzad.benefit.pop.BuzzAdPopTheme
+ import com.buzzvil.buzzbenefit.pop.BuzzPopTheme
  
- val buzzAdPopTheme = BuzzAdPopTheme.getDefault()
-     .iconResId(R.drawable.your_pop_icon)
-     .rewardReadyIconResId(R.drawable.your_pop_icon_reward_ready)
-     .popFeedCloseIconResId(R.drawable.your_pop_icon_feed_close)
- BuzzAdPop.getInstance().setTheme(buzzAdPopTheme)

+ // SDK 초기화 전에 호출합니다.
+ BuzzPopTheme.iconResId = R.drawable.your_pop_icon
+ BuzzPopTheme.rewardReadyIconResId = R.drawable.your_pop_icon_reward_ready

내비게이션 바 기본 UI 삭제

- import com.buzzvil.buzzad.benefit.pop.toolbar.DefaultPopToolbarHolder
- import com.buzzvil.buzzad.benefit.pop.toolbar.PopToolbar
- 
- class YourPopToolbarHolder : DefaultPopToolbarHolder() {
-     override fun getView(activity: Activity, unitId: String): View {
-         super.toolbar = PopToolbar(activity) // PopToolbar 에서 제공하는 기본 Template 사용
-         toolbar.setTitle("TemplatePopToolbarHolder") // 내비게이션 바 타이틀 문구를 변경합니다.
-         toolbar.setIconResource(R.mipmap.ic_launcher) // 내비게이션 바 좌측 아이콘을 변경합니다.
-         toolbar.setBackgroundColor(Color.LTGRAY) // 내비게이션 바 배경색을 변경합니다.
- 
-         addSettingsMenuItemView(activity) // 메뉴 버튼 추가 (메뉴 안에 문의하기 버튼이 있습니다)
-         addInquiryMenuItemView(activity) // 문의하기 버튼은 이 함수를 통해 간단하게 추가 가능합니다.
-         addRightMenuItemView(activity) // custom 버튼 추가
- 
-         return toolbar
-     }
- 
-     // custom 버튼 추가는 toolbar.buildPopMenuItemView 를 사용하여 PopMenuImageView 를 생성하고
-     // toolbar.addRightMenuButton 를 사용하여 toolbar 에 추가합니다.
-     private fun addRightMenuItemView(activity: Activity) {
-         val menuItemView = super.toolbar.buildPopMenuItemView(activity, R.mipmap.ic_launcher)
-         menuItemView.setOnClickListener {
-             super@YourPopToolbarHolder.showInquiry(activity) // 문의하기 페이지로 연결합니다.
-         }
-         toolbar.addRightMenuButton(menuItemView)
-     }
- }

내비게이션 바 커스텀 뷰 삭제

- import android.app.Activity
- import android.graphics.Color
- import android.view.View
- import com.buzzvil.buzzad.benefit.pop.toolbar.DefaultPopToolbarHolder
- import com.buzzvil.buzzad.benefit.pop.toolbar.PopToolbar
- 
- class CustomPopToolbarHolder: DefaultPopToolbarHolder() {
-     override fun getView(activity: Activity, unitId: String): View {
-         super.toolbar = PopToolbar(activity) // PopToolbar에서 제공하는 기본 Template 사용
-         toolbar.setTitle("Custom Title") // 내비게이션 바 타이틀 문구를 변경합니다.
-         toolbar.setIconResource(R.mipmap.ic_launcher) // 내비게이션 바 좌측 아이콘을 변경합니다.
-         toolbar.setBackgroundColor(Color.LTGRAY) // 내비게이션 바 배경색을 변경합니다.
-         
-         super.addSettingsMenuItemView(activity) // 메뉴 버튼 추가 (메뉴 안에 문의하기 버튼이 있습니다)
-         super.addInquiryMenuItemView(activity) // 문의하기 버튼은 이 함수를 통해 간단하게 추가 가능합니다.
-         addRightMenuItemView(activity) // custom 버튼 추가
-         return toolbar
-     }
- 
-     // custom 버튼 추가는 toolbar.buildPopMenuItemView 를 사용하여 PopMenuImageView 를 생성하고
-     // toolbar.addRightMenuButton 를 사용하여 toolbar 에 추가합니다.
-     private fun addRightMenuItemView(activity: Activity) {
-         val menuItemView = toolbar.buildPopMenuItemView(activity, R.drawable.ic_launcher_foreground)
-         menuItemView.setOnClickListener { 
-             super.showInquiry(activity) // 문의하기 페이지로 연결합니다.
-         }
-         
-         toolbar.addRightMenuButton(menuItemView)
-     }
}

- import com.buzzvil.buzzad.benefit.pop.PopConfig
- import com.buzzvil.buzzad.benefit.presentation.feed.FeedConfig
- 
- val popFeedConfig = FeedConfig.Builder("YOUR_POP_UNIT_ID")
-     .build()
- 
- PopConfig.Builder(popFeedConfig)
-     .popToolbarHolderClass(CustomPopToolbarHolder::class.java)
-     .build()

팝 유틸리티 영역 삭제

- import android.content.Context
- import android.view.LayoutInflater
- import android.view.View
- import android.view.ViewGroup
- import com.buzzvil.buzzad.benefit.pop.feedutility.PopUtilityLayoutHandler
- 
- class CustomPopUtilityLayoutHandler(val context: Context): PopUtilityLayoutHandler(context) {
-     override fun onCreateView(parent: ViewGroup?): View {
-         val inflater = LayoutInflater.from(context)
-         return inflater.inflate(R.layout.your_pop_utility_view, parent, false)
-     }
- }

- import com.buzzvil.buzzad.benefit.pop.PopConfig
- import com.buzzvil.sample.buzzvilsdksample.pop.CustomPopUtilityLayoutHandler
- 
- PopConfig.Builder(popFeedConfig)
-     .popUtilityLayoutHandlerClass(CustomPopUtilityLayoutHandler::class.java)
-     .build()

팝 종료 아이콘 삭제

- import com.buzzvil.buzzad.benefit.pop.BuzzAdPop
- import com.buzzvil.buzzad.benefit.pop.BuzzAdPopTheme
- 
- val buzzAdPopTheme = BuzzAdPopTheme.getDefault()
-     .popFeedCloseIconResId(R.drawable.your_pop_icon_feed_close)
- BuzzAdPop.getInstance().setTheme(buzzAdPopTheme)

팝 추가 구현

팝 베네핏허브 표시 화면 변경하기

초기화 시 PopConfig에 BuzzBenefitHubConfig를 설정하여 팝 베네핏허브의 메인 페이지가 아닌 다른 페이지를 바로 열 수 있습니다.

BuzzBenefitHubConfig에 대한 자세한 내용은 베네핏허브 첫 화면 변경하기 토픽을 참고하세요.

// 팝에서 사용할 BuzzBenefitHubConfig 생성
val popBuzzBenefitHubConfig = BuzzBenefitHubConfig.Builder()
    .routePath(BuzzBenefitHubRoutePath.MAIN)
    .build()

val buzzPopConfig = BuzzPopConfig.Builder()
    .buzzPopBenefitHubConfig(popBuzzBenefitHubConfig)
    .build()

val buzzBenefitConfig = BuzzBenefitConfig.Builder("YOUR_APP_ID")
    .setBuzzPopConfig(buzzPopConfig) // BuzzBenefitConfig에 BuzzPopConfig를 설정합니다.
    .build()

인앱 팝

✅  중요
인앱 팝이 삭제되었습니다.

인앱 팝 관련 코드를 모두 삭제하세요.

인앱 팝 표시하기/숨기기 삭제

- import com.buzzvil.buzzad.benefit.pop.inapppop.BuzzAdInAppPop
- 
- class MainActivity : AppCompatActivity() {
-     private lateinit var buzzAdInAppPop: BuzzAdInAppPop
- 
-     override fun onCreate(savedInstanceState: Bundle?) {
-         super.onCreate(savedInstanceState)
-         buzzAdInAppPop = BuzzAdInAppPop.Builder(this).build()
-     }
- 
-     override fun onResume() {
-         super.onResume()
-         buzzAdInAppPop.show(this)
-     }
- 
-     override fun onPause() {
-         super.onPause()
-         buzzAdInAppPop.hide()
-     }
- }

인앱 팝 버튼 아이콘 삭제

- import com.buzzvil.buzzad.benefit.pop.inapppop.BuzzAdInAppPop
- import com.buzzvil.buzzad.benefit.pop.inapppop.BuzzAdInAppPopTheme
- 
- val buzzAdInAppPopTheme = BuzzAdInAppPopTheme.getDefault()
-     .iconResId(R.drawable.your_pop_icon_default) // (선택) Pop 버튼의 기본 아이콘
-     .rewardReadyIconResId(R.drawable.your_pop_icon_reward) // (선택) 적립 가능한 포인트가 있는 경우의 Pop 버튼 아이콘
- 
- buzzAdInAppPop = BuzzAdInAppPop.Builder(this)
-     .theme(buzzAdInAppPopTheme) // 위에서 생성한 객체 전달
-     .build()

커스터마이징

전체 테마

주요 색상

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 버즈빌 대시보드(Dashboard)에서 설정하도록 변경되었습니다.

Buzzvil SDK에서 제공하는 UI 중 다이얼로그의 버튼 색상, 바텀 시트 UI의 확인 버튼 등 앱에 연동한 모든 지면 내 주요 UI의 색상(Primary color)을 변경할 수 있습니다. 색상을 버즈빌 담당자(help@buzzvil.com)에게 전달해 주세요.

리워드 아이콘

팝 아이콘을 제외한 모든 기본 디자인에서 리워드 아이콘을 사용하지 않게 되어 삭제되었습니다. 관련 코드를 삭제하세요.

✏️  참고
커스터마이징을 통해 기존과 동일한 UI를 계속 사용할 수 있습니다. 자세한 내용은 커스터마이징 - CTA 버튼 자체 구현하기, 팝 - 팝 버튼 아이콘 항목을 참고하세요.

- import com.buzzvil.buzzad.benefit.BuzzAdBenefitConfig
- import com.buzzvil.buzzad.benefit.presentation.BuzzAdTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에  GlobalTheme을 설정합니다.
-         val buzzAdTheme = BuzzAdTheme()
-             .rewardIcon(R.drawable.your_reward_icon)
-             .participatedIcon(R.drawable.your_participated_icon)
-         BuzzAdTheme.setGlobalTheme(buzzAdTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

CTA 버튼 자체 구현하기

• CtaView의 이름과 패키지 경로가 변경되었습니다.

- import com.buzzvil.buzzad.benefit.presentation.theme.CtaView
+ import com.buzzvil.buzzbenefit.BuzzCtaView

BuzzAdTheme(Gloabl Theme) 설정 방식 변경

• BuzzAdTheme의 이름과 패키지 경로가 변경되었습니다.
• BuzzAdTheme의 객체 인스턴스 생성 없이 바로 호출하는 방식으로 변경되었습니다.

- import com.buzzvil.buzzad.benefit.presentation.BuzzAdTheme
+ import com.buzzvil.buzzbenefit.pop.BuzzPopTheme
  
  // SDK 초기화 전에 호출합니다.
- val buzzAdTheme = BuzzAdTheme()
-     .ctaViewClass(CustomCtaView::class.java)
- BuzzAdTheme.setGlobalTheme(buzzAdTheme)
+ BuzzTheme.setCustomBuzzCtaView(YourCustomBuzzCtaView::class.java)

베네핏허브 커스터마이징

미션팩

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 미션팩 배경 Gradation 설정하기 기능이 삭제되었습니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.BuzzAdBenefitConfig
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 GlobalTheme을 설정합니다.
-         val buzzAdFeedTheme = BuzzAdFeedTheme.getDefaultFeedTheme()
-             .missionPackGradientColors(intArrayOf(0xAF568DE8.toInt(), 0xAFF4FFB3.toInt()))
-             .missionPackGradientColorPositions(floatArrayOf(0.0f, 1.0f))
-         BuzzAdFeed.setDefaultTheme(buzzAdTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

내비게이션 바

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 관련 설정 또한 버즈빌 대시보드(Dashboard)에서 설정하도록 변경되었습니다. 관련 코드를 삭제하고 변경을 원하는 부분을 버즈빌 담당자(help@buzzvil.com)에게 전달해주세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- 
- val buzzAdFeedTheme = BuzzAdFeedTheme.getDefault()
-     .navigationBarTitle(R.string.your_custom_title)
- BuzzAdFeed.setDefaultTheme(buzzAdFeedTheme)

유저 프로필 입력 배너

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 FeedTheme을 설정합니다.
-         val buzzAdFeedTheme = BuzzAdFeedTheme()
-             .profileBannerIcon(R.drawable.your_profile_banner_icon)
-         BuzzAdFeed.setDefaultTheme(buzzAdFeedTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

헤더

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.header.FeedHeaderViewAdapter
- 
- class CustomFeedHeaderViewAdapter: FeedHeaderViewAdapter {
-     override fun onCreateView(context: Context, parent: ViewGroup): View {
-         val inflater = context.getSystemService(Context.LAYOUT_INFLATER_SERVICE) as LayoutInflater
-         return inflater.inflate(R.layout.feed_header_layout, parent, false)
-     }
-     
-     override fun onBindView(view: View, reward: Int) {
-         val rewardTextView: TextView = view.findViewById(R.id.textReward)
-         rewardTextView.text = reward.toString()
-     }
- 
-     override fun onDestroyView() {
-         // Use this callback for clearing memory
-     }
- }

광고 분류 필터

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 관련 설정 또한 버즈빌 대시보드(Dashboard)에서 설정하도록 변경되었습니다. 변경을 원하는 부분을 버즈빌 담당자(help@buzzvil.com)에게 전달해주세요.

- import com.buzzvil.buzzad.benefit.presentation.BuzzAdTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 GlobalTheme을 설정합니다.
-         val buzzAdTheme = BuzzAdTheme()
-             .usePrimaryColorInFilter(true) // true: primary color, false: monocrhome
-         BuzzAdTheme.setGlobalTheme(buzzAdTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

광고 디자인

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.feed.benefithub.list.adapter.BenefitHubAdViewAdapter
- import com.buzzvil.buzzad.benefit.presentation.feed.FeedConfig

광고 미할당 안내 UI

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 FeedTheme을 설정합니다.
-         val buzzAdFeedTheme = BuzzAdFeedTheme()
-             .noFillErrorImage(R.drawable.your_no_fill_error_image)
-             .noFillErrorTitle(R.string.your_no_fill_error_title)
-             .noFillErrorDescription1st(R.string.your_no_fill_error_description_1st)
-             .noFillErrorDescription2nd(R.string.your_no_fill_error_description_2nd)
-             .noFillErrorDescription3rd(R.string.your_no_fill_error_description_3rd)
-             .noFillErrorDescriptionFinalAllFilter(R.string.your_no_fill_error_description_final_all_filter)
-             .noFillErrorDescriptionFinalOtherFilters(R.string.your_no_fill_error_description_final_other_filters)
-             .noFillErrorButton1st(R.string.your_no_fill_error_button_1st)
-             .noFillErrorButton2nd(R.string.your_no_fill_error_button_2nd)
-             .noFillErrorButton3rd(R.string.your_no_fill_error_button_3rd)
-             .noFillErrorButtonFinalAllFilter(R.string.your_no_fill_error_button_final_all_filter)
-             .noFillErrorButtonFinalOtherFilters(R.string.your_no_fill_error_button_final_other_filters)
-         BuzzAdFeed.setDefaultTheme(buzzAdFeedTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

유저 프로필 오류 안내 UI

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 FeedTheme을 설정합니다.
-         val buzzAdFeedTheme = BuzzAdFeedTheme()
-             .userProfileErrorImage(R.drawable.your_user_profile_error_image)
-             .userProfileErrorTitle(R.string.your_user_profile_error_title)
-             .userProfileErrorDescription(R.string.your_user_profile_error_description)
-         BuzzAdFeed.setDefaultTheme(buzzAdFeedTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

서버 오류 안내 UI

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 FeedTheme을 설정합니다.
-         val buzzAdFeedTheme = BuzzAdFeedTheme()
-             .serverErrorImage(R.drawable.your_server_error_image)
-             .serverErrorTitle(R.string.your_user_profile_error_title)
-             .serverErrorDescription(R.string.your_server_error_description)
-         BuzzAdFeed.setDefaultTheme(buzzAdFeedTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

기타 오류 화면 UI

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 FeedTheme을 설정합니다.
-         val buzzAdFeedTheme = BuzzAdFeedTheme()
-             .privacyPolicyErrorImage(R.drawable.your_privacy_policy_error_image)
-             .agePolicyErrorImage(R.drawable.your_age_policy_error_image)
-             .networkErrorImage(R.drawable.your_nework_error_image)
-             .unknownErrorImage(R.drawable.your_unknown_error_image)
-         BuzzAdFeed.setDefaultTheme(buzzAdFeedTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

팝 추가 유도 모달

Feed(베네핏허브)가 웹 베네핏허브로 변경되며 삭제된 기능입니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeed
- import com.buzzvil.buzzad.benefit.presentation.feed.BuzzAdFeedTheme
- import com.buzzvil.sdk.BuzzvilSdk
- 
- class App : Application() {
-     override fun onCreate() {
-         super.onCreate()
- 
-         val buzzAdBenefitConfig = ...
- 
-         // BuzzvilSdk.initialize()를 호출하기 전에 FeedTheme을 설정합니다.
-         val buzzAdFeedTheme = BuzzAdFeedTheme()
-             .popModalImage(R.drawable.your_pop_modal_image)
-         BuzzAdFeed.setDefaultTheme(buzzAdFeedTheme)
- 
-         // Buzzvil SDK 초기화
-         BuzzvilSdk.initialize(...)
-     }
- }

개인정보 제3자 제공 동의 UI 자체 구현

• PrivacyPolicyManager의 이름과 패키지 경로가 변경되었습니다.
• PrivacyPolicyManager.revokeConsent()가 삭제되었습니다. 동의를 철회하려면 버즈빌 담당자(help@buzzvil.com)에게 전달해 주세요.

- import com.buzzvil.buzzad.benefit.BuzzAdBenefit
+ import com.buzzvil.buzzbenefit.BuzzBenefit

- BuzzAdBenefit.getPrivacyPolicyManager().grantConsent()
+ lifecycleScope.launch(Dispatchers.IO) {
+     // SDK 초기화를 하지 않으면 privacyPolicyManager는 null을 반환합니다.
+ 
+     // 개인정보 동의 여부를 확인합니다.
+     val isConsentGranted: Result<Boolean>? = BuzzBenefit.privacyPolicyManager?.isConsentGranted()
+ 
+     // 직접 구현한 개인정보 제3자 제공 동의 UI에서 동의를 받았을 경우 아래 코드를 실행하면, 베네핏허브 진입 시 개인정보 제3자 제공 동의 UI가 노출되지 않으면서 광고 할당이 정상적으로 진행 됩니다.
+     val result: Result<Unit>? = BuzzBenefit.privacyPolicyManager?.grantConsent()
+ }

- BuzzAdBenefit.getPrivacyPolicyManager().revokeConsent()

커스텀 인앱 브라우저

✅  중요
커스텀 인앱 브라우저가 삭제되었습니다.

커스텀 인앱 브라우저 관련 코드를 모두 삭제하세요.

- import com.buzzvil.buzzad.benefit.presentation.Launcher
- import com.buzzvil.buzzad.benefit.presentation.Launcher.LauncherEventListener
- import com.buzzvil.buzzad.browser.BuzzAdJavascriptInterface

- BuzzAdBenefit.setLauncher(CustomLauncher())

유저 편의 기능

다크 테마(Dark theme) 설정

Buzzvil SDK는 앱의 테마 설정에 따라 자동으로 다크 테마가 적용됩니다. 라이트 테마 또는 다크 테마로 고정하고 싶은 경우 버즈빌 담당자(help@buzzvil.com)에게 연락하세요.

액션형 광고의 유저 문의 기능 추가하기

• BuzzAdBenefit의 이름과 패키지 경로가 변경되었습니다.

- import com.buzzvil.buzzad.benefit.BuzzAdBenefit
+ import com.buzzvil.buzzbenefit.BuzzBenefit

- BuzzAdBenefit.getInstance().showInquiryPage(Context, YOUR_UNIT_ID)
+ BuzzBenefit.showInquiryPage(Context, YOUR_UNIT_ID)

동영상 광고 재생 조건 변경하기

동영상 광고 재생 조건 변경하기 기능이 삭제되었습니다. 관련 코드를 삭제하세요.

- import com.buzzvil.buzzad.benefit.BuzzAdBenefit
- import com.buzzvil.buzzad.benefit.core.models.AutoplayType
- import com.buzzvil.buzzad.benefit.core.models.UserPreferences
- 
- val userPreferences = UserPreferences.Builder(BuzzAdBenefit.getUserPreferences())
-     .autoplayType(AutoplayType.ON_WIFI)
-     // .autoplayType(AutoplayType.DISABLED) // 동영상 광고를 자동으로 재생하지 않습니다.
-     // .autoplayType(AutoplayType.ENABLED) //  동영상 광고를 항상 자동재생합니다.
-     .build()
- BuzzAdBenefit.setUserPreferences(userPreferences)

광고 타입 확인하기

• NativeAd, NativeAd2가 BuzzNativeAd로 통합되었습니다.

- import com.buzzvil.buzzad.benefit.presentation.nativead.NativeAd
- import com.buzzvil.buzzad.benefit.nativead2.api.NativeAd2
+ import com.buzzvil.buzzbenefit.buzznative.BuzzNativeAd

문제 해결하기

오류 코드가 나타납니다

• BuzzAdError의 오류 코드 이름이 일부 변경되었습니다.

✏️  참고
iOS의 오류 코드 이름과 차이가 있는 부분이 수정되었습니다.

- import com.buzzvil.buzzad.benefit.core.ad.AdError
+ import com.buzzvil.buzzbenefit.BuzzAdError

- AdError.INVALID_PARAMETERS
+ BuzzAdError.Type.CLIENT_ERROR

- AdError.PRIVACY_POLICY_NOT_ALLOWED
+ BuzzAdError.Type.PRIVACY_POLICY_NOT_GRANTED