본문으로 건너뛰기

기본 설정

이 페이지에서는 앱에 피드 지면을 표시하고 광고를 할당하는 방법 등 피드 지면을 연동하기 위한 기본적인 설정을 확인할 수 있습니다.

준비 사항​

  • 시작하기 적용 완료
  • 피드 지면에 사용할 Unit ID (이하 YOUR_FEED_UNIT_ID)

피드 지면 초기화하기​

BuzzAdBenefitConfig에 FeedConfig를 추가하세요.

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

        ...
    }
}

✏️  참고
FeedConfig를 사용해 피드 지면의 기능과 디자인을 변경할 수 있습니다. 자세한 내용은 고급 설정과 디자인 커스터마이징 토픽을 참고하세요.

피드 지면 표시하기​

피드 지면은 바텀 시트 형태로 나타납니다.

광고를 할당 받지 않은 상태에서 피드 지면이 사용자에게 표시되면 광고가 자동으로 할당됩니다. 단, 광고를 할당 받는 도중에는 “참여할 수 있는 광고가 없습니다“라는 안내 문구가 나타납니다.

new BuzzAdFeed.Builder().build().show(context);

⚠️  주의
show()를 반복해서 호출하더라도 광고는 갱신되지 않으며 동일한 광고가 호출됩니다.
새로운 광고를 할당받으려면 BuzzAdFeed 인스턴스를 다시 생성하거나, load()를 다시 호출해야 합니다.

✏️  참고
사용자에게 다른 형태로 피드 지면을 제공하려면 프래그먼트로 피드 연동하기 토픽을 참고하세요.

기본 설정 이외의 피드 표시하기​

DefaultFeedConfig로 설정한 FeedConfig를 사용하여 기본 설정을 적용한 피드 이외에, 다른 설정이 적용된 피드를 표시할 수 있습니다. 이를 위해서는 BuzzAdFeed에 새로운 FeedConfig를 등록해야 합니다.
다음의 예시를 참고하세요.

✏️  참고
DefaultFeedCofig를 삭제하지 않아도 됩니다.

final FeedConfig feedConfig = new FeedConfig.Builder("SECOND_FEED_UNIT_ID").build();
BuzzAdFeed buzzAdFeed = new BuzzAdFeed.Builder()
  .feedConfig(feedConfig)
  .build();
buzzAdFeed.show(context);

광고 할당 및 표시하기​

사용자가 개인 정보 처리 방침에 동의한 후 load를 호출하면 광고가 할당됩니다. load를 반복해서 호출하면 광고가 갱신되어 새로운 광고가 할당됩니다.

다음은 광고 할당 후 피드 지면을 표시하는 예시입니다. 다음과 같이 구현하면 사용자가 피드 지면에 진입하기 전에 광고가 할당되어 “참여할 수 있는 광고가 없습니다“라는 안내 문구가 나타나지 않습니다.

❌  오류

BuzzAdFeed buzzAdFeed = new BuzzAdFeed.Builder().build();
buzzAdFeed.load(new BuzzAdFeed.FeedLoadListener() {
    @Override
    public void onSuccess() {
        int feedTotalReward = buzzAdFeed.getAvailableRewards(); // 적립 가능한 총 포인트 금액
        
        buzzAdFeed.show(context);
    }

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

✏️  참고

✅  중요

  • 광고가 정상적으로 표시되면 피드 지면을 성공적으로 연동한 것입니다.
  • 앱 UI에 진입 경로 추가를 참고하여 베네핏허브 유입을 유도해 보세요.