본문으로 건너뛰기

기본 설정

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

준비 사항

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

피드 지면 초기화하기

BuzzAdBenefitConfigFeedConfig를 추가하세요.

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를 통해 원인을 알 수 있습니다.
}
});

✏️  참고

 중요
광고가 정상적으로 표시되면 피드 지면을 성공적으로 연동한 것입니다. 이제 피드 지면의 장점을 한 단계 부스트업할 수 있는 게이미피케이션 기능인 버즈룰렛(BuzzRoulette)을 추가할 수 있습니다. BuzzRoulette 연동을 참고해 버즈룰렛에 대한 자세한 내용을 확인해 보세요.