개요

본 가이드는 BuzzAd SDK의 Feed 지면을 연동하는 방법을 다루는 문서입니다. Feed 지면은 여러 광고를 리스트 형식으로 볼 수 있는 지면입니다.

Feed 지면을 연동하기 전, 시작하기의 연동 사항을 모두 적용했는지 확인해주세요.

Feed 초기화

Application 클래스의 onCreate()에 아래 코드를 추가합니다.

public class App extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        final FeedConfig feedConfig = new FeedConfig.Builder(context, "YOUR_FEED_UNIT_ID")
            .feedHeaderViewAdapterClass(DefaultFeedHeaderViewAdapter.class)
            .build();
        final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context)
            .setFeedConfig(feedConfig)
            .build();
        BuzzAdBenefit.init(this, buzzAdBenefitConfig);

        ...생략...
    }
}

Feed 보여주기

FeedHandler 클래스를 이용하여 피드를 사용자에게 보여줍니다. 피드를 보여주는 시점은 사용자가 앱 내의 특정 버튼을 탭했거나 BuzzAdBenefit SDK에서 제공하는 다양한 진입 경로(EntryPoint)가 될 수 있습니다. 여기서는 사용자가 매체 사에서 구현한 버튼이나 배너 등을 탭했을 때 피드를 보여주는 방법을 안내합니다.

final FeedHandler feedHandler = new FeedHandler(context, "YOUR_FEED_UNIT_ID");
feedHandler.startFeedActivity(this);

SDK에서 제공하는 Activity가 아닌 다른 형태로 Feed를 보여주고 싶다면 고급 설정을 참고하세요.

startFeedActivity()를 반복해서 호출하더라도 광고는 갱신되지 않고 동일한 광고가 보입니다.
새로운 광고를 할당하기 위해서는 FeedHandler 인스턴스를 다시 생성하거나, preload() 를 다시 호출해야합니다.

광고 할당 받기

preload()를 호출하여 광고를 할당받을 수 있습니다. preload()를 반복해서 호출하면 광고가 갱신됩니다.

다음은 광고 할당 후 Feed 지면을 표시하는 예시입니다. 다음과 같이 구현하면 사용자가 Feed 지면에 진입하기 전에 광고 할당이 보장되기 때문에 “참여할 수 있는 광고가 없습니다.“는 이미지를 보이지 않습니다.

final FeedHandler feedHandler = new FeedHandler(context, "YOUR_FEED_UNIT_ID");
feedHandler.preload(new FeedHandler.FeedPreloadListener() {
    @Override
    public void onPreloaded() {
        int feedAdSize = feedHandler.getSize(); // 광고의 개수
        int feedTotalReward = feedHandler.getTotalReward(); // 적립 가능한 총 포인트 금액
        ...
        
        feedHandler.startFeedActivity(context);
    }

    @Override
    public void onError(AdError error) {
        // 광고가 없을 경우 호출됩니다. error를 통해 원인을 알 수 있습니다
    }
});

Buzzvil Developer Guides

3.1. 기본 설정

Analytics

개요

Feed 초기화

Feed 보여주기

광고 할당 받기

Related content