본문으로 건너뛰기

버즈배너(BuzzBanner)

버즈배너(BuzzBanner)는 사용자 경험을 고려한 동시에 인벤토리 수익을 증대할 수 있는 비보상형 광고 상품입니다. 버즈배너는 피드 또는 팝 피드와 광고 참여 안내 페이지 아래 영역에 연동할 수 있으며, 이 외에도 원하는 위치 어디에나 연동할 수 있습니다.

 중요

  • BuzzBanner는 Android용 BuzzAd SDK v3.25.x 이상부터 지원합니다.
  • 연동을 위해서는 버즈빌 담당자에게 연락하시기 바랍니다.

버즈배너 연동하기

피드, 팝 피드, 광고 참여 안내 페이지 하단에 연동하기

피드 또는 팝 피드와 광고 참여 안내 페이지 아래 영역에 코드 수정 없이 쉽고 버즈배너를 연동할 수 있습니다. 연동을 위해서는 버즈빌 담당자에게 연락하시기 바랍니다.

원하는 위치에 버즈배너 연동하기

원하는 위치에 버즈배너를 연동하려면 다음의 절차를 따르세요.

  1. 원하는 버즈배너 사이즈를 결정하세요.

버즈배너 사이즈

SizeEnum
Banner 320 x 50BuzzBanner.BannerSize.W320XH50
Banner 320 x 100BuzzBanner.BannerSize.W320XH100
  1. 버즈빌 담당자에게 연락하여 연동을 위한 Placement ID, Banner Size 를 받으세요.
ID 유형설명
Placement ID각 광고 지면을 구분하게 하는 고유 ID 입니다. 배너의 사이즈와 PlacementID 가 제대로 매칭되어야 광고 할당 및 노출이 정상적으로 이루어집니다.
Banner Size노출되는 버즈배너의 사이즈를 결정해주는 값 입니다.
  1. 원하는 위치에 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)

  1. 프로젝트 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle

allprojects {
repositories {
maven {
url 'https://devrepo.kakao.com/nexus/content/groups/public/'
}
}
}
  1. App 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
// 모듈 레벨의 build.gradle 

dependencies {
implementation "com.kakao.adfit:ads-base:3.12.7"
}

Cauly

  1. 프로젝트 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle

allprojects {
repositories {
maven {
url "s3://repo.cauly.net/releases"
credentials(AwsCredentials) {
accessKey "AKIAWRZUK5MFKYVSUOLB"
secretKey "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"
}
}
}
}
  1. 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

  1. 프로젝트 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle

allprojects {
repositories {
maven {
url "https://artifact.bytedance.com/repository/pangle"
}
}
}
  1. 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

  1. 프로젝트 레벨의 build.gradle 파일에 아래 코드를 설정하세요.
// 프로젝트 레벨의 build.gradle

allprojects {
repositories {
maven {
url "https://raw.githubusercontent.com/coupang-ads-sdk/android/main"
}
}
}
  1. 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은 추가할 수 없습니다.