Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

목차

Table of Contents

...

minLevel1
maxLevel1
exclude목차

개요

이 문서에서 가이드 하는 내용은 BuzzAd Android SDK의 만보기 지면의 기능을 설명하고 각 기능을 변경하는 방법을 설명합니다.

메인 페이지 헤더 Custom View 자체 구현

Table of Contents

<<메인페이지의 헤더 영역 강조 이미지>>

...

Table of Contents
minLevel1
maxLevel7
include(만보기 기능 API)

메인 페이지의 헤더 영역을 직접 구현한 Custom View로 대체하는 방법을 설명합니다. Custom View를 직접 구현하지 않고 기본 헤더를 Config 설정으로 간단히 변경하기 위해서는 UI 커스터마이징을 참고하시기 바랍니다.

다음은 메인페이지 메인 페이지 헤더를 Custom View로 대체하는 예시입니다. 만보기 기능을 View로 구현하는데 필요한 API는 코드 예시 하단에 있습니다.

Code Block
languagejava
public class YourPedometerPopHeaderViewAdapter extends PedometerPopHeaderViewAdapter {

    @NotNull
    @Override
    public View createView(@NotNull Context context, @NotNull ViewGroup parent) {
        this.context = context;
        View view =  LayoutInflater.from(context).inflate(
                R.layout.your_custom_header_layout,
                parent,
                false
        );
        setPedometer(); // API를 이용하여 자체 구현
        return view;
    }
}

만보기 기능 API

...

API

...

설명

...

getMaxProgress()

...

Pedometer Header 상단에 표시되는 progress 의 최대 값 (10000)

...

getProgress()

...

Pedometer Header 상단에 표시되는 progress 의 현재 값 ((걸음 수/마일스톤 목표 걸음 수) * maxProgress)

...

isRewardable()

...

적립가능 한 마일스톤이 있으면 true

...

getStep()

...

현재 걸음 수

...

getMilestones()

...

모든 마일스톤(List<Milestone>)

...

getPopPedometerHeaderEventListener()

...

Override 하여 PopPedometerHeaderEventListener를 등록합니다. PopPedometerHeaderEventListener는 만보기 이벤트가 발생할 경우 콜백이 발생합니다.

...

PopPedometerHeaderEventListener.onStepChanged

...

걸음 수 가 변했을 때 호출됩니다.

...

PopPedometerHeaderEventListener.onMilestoneReached

...

마일스톤 목표 달성 시 호출됩니다.

...

PopPedometerHeaderEventListener.onMilestoneUpdated

...

마일스톤 정보가 변경 됐을 때 호출됩니다.

...

navigateToPedometer()

...

Pedometer Fragment 로 화면 전환합니다.

...

navigateToPedometerHistory()

...

BuzzAdBenefit 초기화 시, Pop 의 FeedConfig 에서 MyPedometerPopHeaderViewAdapter 사용하도록 설정합니다.

Code Block
languagejava
final FeedConfig feedConfig = new FeedConfig.Builder(getApplicationContext(), UNIT_ID_POP)
        .feedHeaderViewAdapterClass(YourPedometerPopHeaderViewAdapter.class)
        .build();
        
popConfig = new PopConfig.Builder(getApplicationContext(), UNIT_ID_POP)
        .feedConfig(feedConfig)
        .build();
        
final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(this)
        .setPopConfig(popConfig)
        .build();
        
BuzzAdBenefit.init(this, buzzAdBenefitConfig);

만보기 기능 API

API

설명

getMaxProgress()

Pedometer Header 상단에 표시되는 progress 의 최댓 값 (10000)

getProgress()

Pedometer Header 상단에 표시되는 progress 의 현재 값 ((걸음 수/마일스톤 목표 걸음 수) * maxProgress)

isRewardable()

적립 가능 한 마일스톤이 있으면 true

getStep()

현재 걸음 수

getMilestones()

모든 마일스톤(List<Milestone>)

getPopPedometerHeaderEventListener()

Override 하여 PopPedometerHeaderEventListener를 등록합니다. PopPedometerHeaderEventListener는 만보기 이벤트가 발생할 경우 콜백이 발생합니다.

PopPedometerHeaderEventListener.onStepChanged

걸음 수가 변했을 때 호출됩니다.

PopPedometerHeaderEventListener.onMilestoneReached

마일스톤 목표 달성 시 호출됩니다.

PopPedometerHeaderEventListener.onMilestoneUpdated

마일스톤 정보가 변경됐을 때 호출됩니다.

navigateToPedometer()

Pedometer Fragment로 화면 전환합니다.

navigateToPedometerHistory()

PedometerHistory Fragment로 화면 전환합니다.

만보기 튜토리얼 URL 설정

...

만보기 튜토리얼을 설정할 수 있습니다. 튜토리얼 버튼은 히스토리 UI와 적립 UI의 헤더 우측에 있습니다우측 상단에 있습니다.

다음은 튜토리얼 페이지를 변경하는 예시입니다.

Code Block
final PedometerConfig pedometerConfig new PedometerConfig.Builder(context, "YOUR_UNIT_ID_PEDOMETER", "YOUR_UNIT_ID_PEDOMETER_REWARD")
        .tutorialUrl("YOUR_TUTORIAL_URL")
        .build();

final PopConfig popConfig = new PopConfig.Builder(context, unitIdPop)  
        .pedometerConfig(pedometerConfig)
        .build();

만보기 광고 지면 추가: 진입

...

만보기 적립 UI에 Interstitial 지면을 추가합니다. 사용자가 만보기 적립 UI에 진입할 때 Interstitial 광고를 보여줍니다. Interstitial 지면을 추가하기 위해서는 unit id를 PedometerConfig에 설정해야 합니다광고가 보입니다.

다음은 적립 UI에 Interstitial 지면을 추가하는 방법입니다. Unit id 발급이 필요한 경우에는 버즈빌 매니저에게 문의하시기 바랍니다.

Code Block
final PedometerConfig pedometerConfig new PedometerConfig.Builder(context, "YOUR_UNIT_ID_PEDOMETER", "YOUR_UNIT_ID_PEDOMETER_REWARD")
        .pedometerIntroUnitId("YOUR_PEDOMETER_INTRO_UNIT_ID")
        .build();

final PopConfig popConfig = new PopConfig.Builder(context, unitIdPop)  
        .pedometerConfig(pedometerConfig)
        .build();

Pop 광고 지면 추가: 히스토리 페이지

<< 이미지 >>

...

만보기 히스토리 UI에 Interstitial 지면을 추가합니다. 사용자가 만보기 히스토리 UI에 진입할 때 Interstitial 광고를 보여줍니다. Interstitial 지면을 추가하기 위해서는 unit id를 PedometerConfig에 설정해야 합니다광고가 보입니다.

다음은 히스토리 UI에 Interstitial 지면을 추가하는 예시입니다. Unit id 발급이 필요한 경우에는 버즈빌 매니저에게 문의하시기 바랍니다.

...