목차
| Table of Contents | ||||||
|---|---|---|---|---|---|---|
|
개요
본 가이드에서는 BuzzAd Android SDK에서 제공하는 UI의 구성을 지키며 디자인을 변경하기 위한 방법을 안내합니다. 추가적인 디자인 변경을 원하시는 경우에는 고급 설정에서 UI를 자체 구현하는 방법으로 진행할 수 있습니다.
Pop 디자인 가이드 문서
Pop 디자인 규격은 Pop 디자인 가이드 문서에서 확인 가능합니다. Pop의 디자인을 변경하기 위해서는 PopConfig를 설정해야 합니다.
Pop 배경색 변경
...
Pop의 배경색은 https://buzzvil.atlassian.net/wiki/spaces/BDG/pages/2164329086/ver%2B2.23.x%2B9.#PrimaryColor-%EB%B3%80%EA%B2%BD 테마 적용에 따라 변경할 수 있습니다.
...
Pop 아이콘 변경
...
PopConfig의 iconResId 와 rewardReadyIconResId 를 PopConfig를 설정하여 Pop 아이콘 이미지를 변경할 수 있습니다.
다음은 Pop 아이콘을 변경하는 예시입니다.
| Code Block | ||
|---|---|---|
| ||
PopConfig popConfig = new PopConfig.Builder(context, "YOUR_POP_UNIT_ID")
.iconResId(R.drawable.your_pop_icon)
.rewardReadyIconResId(R.drawable.you_pop_icon_reward_ready)
.build(); |
...
Pop이 활성화되어 있는 동안에 Service Notification이 보입니다.
다음은 PopNotificationConfig를 설정하여 BuzzAd Android SDK에서 제공하는 Notification 의 UI를 변경하는 방법을 안내합니다. UI 레이아웃 혹은 Notification 전체를 수정하기 위해서는 Pop Service Notification 자체 구현을 참고하시기 바랍니다. 방법입니다.
| Code Block | ||
|---|---|---|
| ||
final PopNotificationConfig popNotificationConfig = new PopNotificationConfig.Builder(context)
.smallIconResId(R.drawable.your_small_icon) // 흰색 아이콘, Adaptive Icon 이 설정하지 않도록 주의 요망
.titleResId(R.string.your_pop_notification_title)
.textResId(R.string.your_pop_notification_text)
.colorResId(R.color.your_pop_notification_color)
.notificationId(5000) // 기본값
.build();
PopConfig popConfig = new PopConfig.Builder(context, "YOUR_POP_UNIT_ID")
.popNotificationConfig(popNotificationConfig)
.build(); |
UI 레이아웃 혹은 Notification 전체를 수정하기 위해서는 Pop Service Notification 자체 구현을 참고하시기 바랍니다.
툴바 영역 커스터마이징
다음은 툴바 영역의 아이콘 색상을 변경하는 방법을 안내합니다.
...
...
BuzzAd Android SDK에서 제공하는 Pop 툴바 영역의 좌측 아이콘 색상은 테마 적용에 따라 변경할 수 있습니다.
스낵바 및 토스트 메시지 커스터마이징
...
Pop 지면에서 사용자에게 리워드가 부여되었을 때 스낵바 혹은 토스트가 표시됩니다. DefaultPopFeedbackHandler의 상속 클래스를 구현하여 스낵바 혹은 토스트에 표시되는 메시지를 변경할 수 있습니다. 상속 클래스는 PopConfig의 popFeedbackHandlerClass로 설정합니다.사용자에게 리워드를 지급할때 안내 문구를 스낵바 혹은 토스트에 표시합니다. 기본 문구는 광고 적립 포인트 n포인트 적립되었습니다. 입니다.
다음은 DefaultPopFeedbackHandler의 구현 클래스를 구현하고, 직접 작성한 문구(message)로 스낵바 혹은 토스트를 표시하는 예제입니다.
| Code Block |
|---|
public class CustomPopFeedback extends DefaultPopFeedbackHandler {
// 광고 적립에 성공 시, 호출됩니다.
@Override
public void notifyNativeAdReward(
@NotNull Context context,
@NotNull View view,
boolean canUseSnackbar, //snackbar 사용 가능 여부
int reward // 적립된 리워드 양
) {
String message = "Customized feed launch reward message";
if (canUseSnackbar) {
showSnackbar(message, view); // 구현 필요
} else {
showToast(message); // 구현 필요
}
}
} |
| Code Block | ||
|---|---|---|
| ||
PopConfig popConfig = new PopConfig.Builder(this, "YOUR_FEED_UNIT_ID")
.popFeedbackHandlerClass(CustomPopFeedbackHandlerClass.class)
.build(); |
...
methods
...
Description
...
notifyNativeAdReward
...
광고 적립에 성공 시, 호출됩니다.
디폴트 메세지: 광고 적립 포인트 n포인트 적립되었습니다.
...
Parameters
...
Description
...
context
...
snackbar나 toast를 사용할 때 인자로 넘겨주는 context입니다.
...
view
...
snackbar를 사용할 때 인자로 넘겨주는 view입니다.
...
canUseSnackbar
...
snackbar를 사용할 수 있는 상태인지를 알려주는 flag입니다.
...
reward
...
적립된 리워드 양을 나타냅니다. reward를 사용해서 유저에게 좀 더 구체적인 피드백을 제공할 수 있습니다.
|