버즈배너(BuzzBanner)
버즈배너(BuzzBanner)는 사용자 경험을 고려한 동시에 인벤토리 수익을 증대할 수 있는 비보상형 광고 상품입니다. 버즈배너는 피드 또는 팝 피드와 광고 참여 안내 페이지 아래 영역에 연동할 수 있으며, 이 외에도 원하는 위치 어디에나 연동할 수 있습니다.
✅ 중요
- BuzzBanner는 Android용 BuzzAd SDK v3.25.x 이상부터 지원합니다.
- 연동을 위해서는 버즈빌 담당자에게 연락하시기 바랍니다.
버즈배너 연동하기
피드, 팝 피드, 광고 참여 안내 페이지 하단에 연동하기
피드 또는 팝 피드와 광고 참여 안내 페이지 아래 영역에 코드 수정 없이 쉽고 버즈배너를 연동할 수 있습니다. 연동을 위해서는 버즈빌 담당자에게 연락하시기 바랍니다.
원하는 위치에 버즈배너 연동하기
원하는 위치에 버즈배너를 연동하려면 다음의 절차를 따르세요.
- 원하는 버즈배너 사이즈를 결정하세요.
버즈배너 사이즈
Size | Enum |
---|---|
Banner 320 x 50 | BuzzBanner.BannerSize.W320XH50 |
Banner 320 x 100 | BuzzBanner.BannerSize.W320XH100 |
- 버즈빌 담당자에게 연락하여 연동을 위한 Placement ID, Banner Size 를 받으세요.
ID 유형 | 설명 |
---|---|
Placement ID | 각 광고 지면을 구분하게 하는 고유 ID 입니다. 배너의 사이즈와 PlacementID 가 제대로 매칭되어야 광고 할당 및 노출이 정상적으로 이루어집니다. |
Banner Size | 노출되는 버즈배너의 사이즈를 결정해주는 값 입니다. |
- 원하는 위치에
BuzzBannerView
를 추가하세요.
<com.buzzvil.buzzbanner.BuzzBannerView
android:id="@+id/buzzBannerView"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
버즈배너 Placement ID와 사이즈 설정하기
버즈배너 Placement ID와 사이즈를 설정하는 방법은 두 가지가 있습니다.
XML 파일에서 속성으로 설정하기
<com.buzzvil.buzzbanner.BuzzBannerView
android:id="@+id/buzzBannerView"
app:bz_placement_id="BANNER_PLACEMENT_ID"
app:bz_banner_size="size_320x50"
android:layout_width="match_parent"
android:layout_height="wrap_content" />
<!-- app:bz_banner_size="size_320x50" or "size_320x100" -->
소스코드에서 설정하기
private void setBuzzBannerConfig() {
BuzzBannerConfig buzzBannerConfig = new BuzzBannerConfig.Builder()
.bannerSize(BuzzBanner.BannerSize.W320XH50) // BuzzBanner.BannerSize.W320XH50 or BuzzBanner.BannerSize.W320XH100
.placementId("BANNER_PLACEMENT_ID")
.build();
BuzzBannerView buzzBannerView = findViewById(R.id.buzzBannerView);
buzzBannerView.setBuzzBannerConfig(buzzBannerConfig);
}
BuzzBannerView
의 Lifecycle 관련 함수 호출하기
XML 파일 또는 소스코드에서 설정한 후에는 반드시 BuzzBannerView
의 Lifecycle 관련 함수를 호출해 주어야 합니다.
public class YourActivity extends AppCompatActivity {
...
BuzzBannerView buzzBannerView;
BuzzBannerViewListener buzzBannerViewLister;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_your);
buzzBannerView = findViewById(R.id.buzzBannerView);
setBuzzBannerConfig();
// optional : 배너 광고에 대한 CallBack 을 설정할 수 있습니다.
buzzBannerView.setBuzzBannerViewListener(buzzBannerViewListener);
}
private void setBuzzBannerConfig() {
BuzzBannerConfig buzzBannerConfig = new BuzzBannerConfig.Builder()
.bannerSize(BuzzBanner.BannerSize.W320XH50) // BuzzBanner.BannerSize.W320XH50 or BuzzBanner.BannerSize.W320XH100
.placementId("BANNER_PLACEMENT_ID")
.build();
buzzBannerView.setBuzzBannerConfig(buzzBannerConfig);
}
@Override
protected void onResume() {
super.onResume();
buzzBannerView.onResume(YourActivity.this);
}
@Override
protected void onPause() {
super.onPause();
buzzBannerView.onPause();
}
@Override
protected void onDestroy() {
buzzBannerView.onDestroy();
super.onDestroy();
}
...
}
옵션: 버즈배너 광고 콜백 리스너 등록하기
배너 광고에 대한 콜백을 받기 위해 BuzzBannerView
에 Load 상태를 따르는 리스너를 등록할 수 있습니다.
// BuzzBannerViewLisetner.java
interface BuzzBannerViewListener {
public void onLoaded()
public void onFailed(AdError adError)
public void onClicked()
}
BuzzBanner 수익 증대를 위한 ADN 추가 연동
BuzzBanner의 매출 극대화를 위해 추가 연동 가능한 Ad Network 연동 가이드입니다.
✏️ 참고
- 사용하고자 하는 ADN SDK를
build.gradle
에서 설정할 수 있습니다.- 호환 버전 이외의 버전을 사용하고자 하는 경우 반드시 버즈빌 담당자에게 문의 후 사용하시기 바랍니다.
Adfit(Kakao)
- 프로젝트 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle
allprojects {
repositories {
maven {
url 'https://devrepo.kakao.com/nexus/content/groups/public/'
}
}
}
- App 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
implementation "com.kakao.adfit:ads-base:3.12.7"
}
Cauly
- 프로젝트 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle
allprojects {
repositories {
maven {
url "s3://repo.cauly.net/releases"
credentials(AwsCredentials) {
accessKey "AKIAWRZUK5MFKYVSUOLB"
secretKey "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"
}
}
}
}
- App 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
implementation "com.fsn.cauly:cauly-sdk:3.5.22"
}
Mobon
App 레벨의 build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
implementation("io.github.mobon:mobonSDK:1.0.0.54") {
transitive = true
exclude group: 'com.google.android.gms'
}
}
Pangle
- 프로젝트 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle
allprojects {
repositories {
maven {
url "https://artifact.bytedance.com/repository/pangle"
}
}
}
- App 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
implementation "com.pangle.global:ads-sdk:4.7.1.4"
}
UnityAds
App 레벨의 build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
implementation "com.unity3d.ads:unity-ads:4.3.0"
}
Vungle
App 레벨의 build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
implementation "com.vungle:publisher-sdk-android:6.11.0"
}
Coupang
- 프로젝트 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle
allprojects {
repositories {
maven {
url "https://raw.githubusercontent.com/coupang-ads-sdk/android/main"
}
}
}
- App 레벨의
build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
// 별도 설정 정보를 포함한 구성 설정
implementation "org.bitbucket.avatye.sdk-cash-block:plug-archive-coupang:1.2.8"
}
✏️ 참고 쿠팡 SDK 1.2.1 버전이 포함되어 있습니다.
Adfit(Kakao)
App 레벨의 build.gradle
파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle
dependencies {
// 별도 설정 정보를 포함한 구성 설정
implementation "org.bitbucket.avatye.sdk-cash-block:plug-archive-applovin:1.2.8"
}
✏️ 참고 AppLovin SDK 11.3.3 버전이 포함되어 있습니다. ❌ 오류
기존에 버즈룰렛(BuzzRoulette)을 연동한 경우 AppLovin ADN을 추가하면 충돌이 발생합니다. BuzzRoulette을 연동하고 있다면 AppLovin은 추가할 수 없습니다.