목차
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
개요
본 가이드에서는 BuzzAd Android SDK의 Pop 지면의 기능을 설명하고 각 기능을 변경하는 방법을 설명합니다.
...
PopConfig 설정
...
PopConfig를 통해 Pop의 기능을 설정할 수 있습니다. BuzzAdBenefitConfig에
다음은 PopConfig를 추가합니다 BuzzAdBenefitConfig에 추가하는 예시입니다.
| Code Block | ||
|---|---|---|
| ||
PopConfig popConfig = new PopConfig.Builder(getApplicationContext(), "YOUR_POP_UNIT_ID")
.build();
final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context)
...생략...setPopConfig(popConfig)
.setPopConfigbuild(popConfig));
BuzzAdBenefit.init(this, buzzAdBenefitConfig); |
Pop 활성화 버튼
...
Feed 지면에 Pop 지면 활성화 버튼을 표시할 수 있습니다. 사용자는 Pop 지면 활성화 버튼을 통해 자연스럽게 Pop 을 활성화할 수 있습니다.
사용자에게 Pop 활성화 버튼을 표시하는 방법은 다음과 같습니다.
PopConfig를 설정하지 않고, FeedConfig를 아래와 같이 설정한 경우
Code Block FeedConfig feedConfig = new FeedConfig.Builder(getApplicationContext(), YOUR_FEED_UNIT_ID) .optInFeatureList(Collections.singletonList(OptInFeature.Pop)) .build();PopConfig를 설정한 경우
Code Block language java PopConfig popConfig = new PopConfig.Builder(getApplicationContext(), "YOUR_POP_UNIT_ID") .build(); final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context) .setPopConfig(popConfig) // PopConfig 설정 .build(); BuzzAdBenefit.init(this, buzzAdBenefitConfig);
위의 조건을 충족하도록 연동했다면, Pop을 활성화하지 않은 사용자에게 Pop 활성화 버튼이 보입니다.
Pop 활성화 버튼을 표시하지 않기 위해서는 아래와 같이 설정해야합니다. 위의 표시 가능 조건과 무관하게 Pop 활성화 버튼은 보이지 않습니다.
| Code Block | ||
|---|---|---|
| ||
final FeedConfig feedConfig = new FeedConfig.Builder(context, "YOUR_FEED_UNIT_ID") .optInAndShowPopButtonHandler(null) // Pop 활성화 버튼 숨김 .build(); BuzzAdBenefit.init(this, buzzAdBenefitConfig); |
커스텀 페이지 추가
Pop 지면을 이용하여 원하는 내용을 표시할 수 있습니다. 커스텀 페이지는 툴바와 컨텐츠로 이루어져있습니다.
...
| Code Block | ||
|---|---|---|
| ||
// AndroidManifest.xml
<application
...생략...
<service android:name=".java.YourControlService" />
...생략...
</application> |
툴바 영역 View 자체 구현
...
Pop지면의 툴바 영역에 직접 구현한 View를 등록하여 영역의 UI를 변경할 수 있습니다. Buzzvil Android SDK가 제공하는 UI을 이용하여 변경하는 방법과 사용하지 않고 변경하는 방법이 있습니다.
...
Android SDK가 제공하는 UI을 이용하여 변경하는 방법과 사용하지 않고 변경하는 방법이 있습니다.
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
SDK에서 제공하는 UI를 이용하여 변경
...
기본으로 제공되는 UI를 이용하여 변경하는 방법입니다. 간단하지만 제약이 있습니다.
...
UI를 직접 구현하여 변경
Notification의 동작, UI 레이아웃까지 직접 구현하여 변경하는 방법입니다.
1. SDK가 제공하는 UI를 이용하여 변경
...
DefaultPopToolbarHolder의 상속 클래스는 구현하여 툴바를 변경합니다. SDK에서 제공하는 PopToolbar 를 이용하여 정해진 레이아웃에서 변경합니다. 상속 클래스는 PopConfig의 feedToolbarHolderClass에 설정합니다.
다음은 SDK가 BuzzAd Android SDK에서 제공하는 UI를 이용하여 구현하는 예시입니다.
...
| Code Block | ||
|---|---|---|
| ||
new PopConfig.Builder(getApplicationContext(), "YOUR_POP_UNIT_ID")
.feedToolbarHolderClass(YourPopToolbarHolder.class)
.build(); |
...
Custom View를 직접 구현하여 UI를 변경
...
DefaultPopToolbarHolder의 DefaultPopToolbarHolder의 상속 클래스는 구현하여 툴바를 변경합니다. SDK에서 제공하는 PopToolbar를 사용하지 않고 직접 구성한 레이아웃을 사용합니다. 그리고 구현한 상속 클래스는 PopConfig의 feedToolbarHolderClass PopConfig에 설정합니다.
다음은 레이아웃을 직접 구성하여 구현하는 예제입니다.
...
| Code Block | ||
|---|---|---|
| ||
new PopConfig.Builder(getApplicationContext(), "YOUR_POP_UNIT_ID")
.feedToolbarHolderClass(YourPopToolbarHolder.class)
.build(); |
유틸리티 영역
...
UI 변경
...
유틸리티 영역은 영역을 활용하여 사용자에게 편리한 기능을 제공합니다.
다음은 유틸리티 영역을 변경하는 예시입니다.
PopUtilityLayoutHandler의 상속 클래스를 구현하여 변경할 수 있습니다. 유틸리티 영역에 넣고 싶은 View를 직접 구현하여 onLayoutCreated 시 parent에 추가합니다. 상속 클래스는 PopConfig의 popUtilityLayoutHandlerClass에 설정합니다구현하고, 구현한 Custom View(your_pop_utility_view)를 추가합니다. 그리고 FeedConfig에 구현한 클래스를 추가합니다.
| Code Block | ||
|---|---|---|
| ||
public final class CustomPopUtilityLayoutHandler extends PopUtilityLayoutHandler {
private Context context;
public CustomPopUtilityLayoutHandler(Context context) {
super(context);
this.context = context;
}
@Override
public void onLayoutCreated(ViewGroup parent) {
LayoutInflater inflater = LayoutInflater.from(context);
final FrameLayout layout = (FrameLayout) inflater.inflate(
R.layout.your_pop_utility_view,
parent,
false
);
parent.addView(layout);
}
}
new PopConfig.Builder(getApplicationContext(), "YOUR_POP_UNIT_ID")
.popUtilityLayoutHandlerClass(CustomPopUtilityLayoutHandler.class)
.build(); |
| Info |
|---|
유틸리티 영역 아이콘 디자인 규격
|
추가 Interstitial 광고 지면
...
연동
...
popExitUnitId를 설정하면 Pop 지면에 추가로 Interstitial 지면을 연동할 수 있습니다. 사용자가 Pop 지면에서 지면을 이탈을 할 때, Interstitial 광고를 노출합니다. Interstitial 지면의 unit id 발급을 원하시는 경우에는 버즈빌 매니저에게 문의하시기 바랍니다지면이 보입니다. Interstitial 지면을 추가하기 위해서는 PopConfig에 Interstitial 지면 unit id를 설정합니다. Unit id 발급이 필요한 경우에는 버즈빌 매니저에게 문의하시기 바랍니다.
다음은 Interstitial 지면을 추가하는 예시입니다.
| Code Block |
|---|
PopConfig popConfig = new PopConfig.Builder(context, "YOUR_POP_UNIT_ID")
.popExitUnitId("YOUR_POP_EXIT_UNIT_ID")
.build(); |
Pop 종료 시 보이는 위의 Interstitial 지면은 제3의 ADN 광고를 포함한 버즈빌의 광고를 함께 할당합니다할당할 수 있습니다. 더 많은 광고 물량 확보를 위해 제3의 ADN 연동을 권장합니다. 위의 Interstitial 지면에 연동할 수 있는 ADN은 다음과 같습니다.
AdfitNative ADN (단, 연동 심사 필요)
ADN 광고를 연동하기 위해서 (ver 2.25.x) 7. 추가 Adnetwork 연동를 ADN 연동을 참고하시기 바랍니다.