개요

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

...

...

final BuzzAdBenefitConfig buzzAdBenefitConfig = new BuzzAdBenefitConfig.Builder(context)
        .add(feedConfig)
        .build();
BuzzAdBenefit.init(this, buzzAdBenefitConfig);

...

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

1. FeedConfig를 설정할 때 사용한 Feed unit id("YOUR_FEED_UNIT_ID")로 FeedHandler를 생성합니다.

2. startFeedActivity()를 호출하여 Feed 액티비티를 실행합니다.

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

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

Feed의 진입 전 광고 할당 받기

바로 startFeedActivity를 호출하는 경우 Feed 액티비티가 실행되면서 광고를 로드하게 되어, 유저에게 보여줄 수 있는 광고가 없어 빈 화면이 보이게 될 수도 있습니다. 이에 Feed 액티비티를 실행하기 전에 preload()를 호출한 뒤 onPreloaded() 콜백을 호출하여 상태를 확인한 후 광고가 있을때만 피드로 진입할 수 있도록 하는 것을 추천합니다.

...

feedHandler.getSize() : 광고의 개수

...

유저가 Feed지면에 접근하기 전에 서버로 부터 광고를 미리 할당받기 위해서 preload를 사용할 수 있습니다.
preload에 성공하여 광고가 할당된 경우 FeedPreloadListene.onPreloaded가 호출되며, 광고 할당에 실패한 경우 FeedPreloadListene.onError가 호출됩니다.

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

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

개인정보 취급 방침

개인정보 보호법과 구글 정책에 에 따라, 개인정보 수집 및 사용에 대한 유저의 동의가 필요합니다. 미동의시 Feed 지면을 이용할 수 없습니다.

버즈빌 SDK에서 개인정보 취급 방침 동의 UI를 제공하고 있으며 아래 그림과 같이 표시됩니다.

...

개인정보 취급 방침과 관련해서 다음과 같은 API를 사용할 수 있습니다.

// 개인정보 취급 방침 UI를 보여주는 API
BuzzAdBenefit.getPrivacyPolicyManager().showContentUI(context, listener);

// 개인정보 취급 방침에 대해 `동의함`을 표시
BuzzAdBenefit.getPrivacyPolicyManager().grantConsent();
// 개인정보 취급 방침에 대해 `동의하지 않음`을 표시
BuzzAdBenefit.getPrivacyPolicyManager().revokeConsent();
// 개인정보 취급 방침에 `동의함` 여부를 확인
BuzzAdBenefit.getPrivacyPolicyManager().isConsentGranted();

...