기본 설정
1 단계. 준비하기
- 시작하기 적용 완료
- 인터스티셜 지면에 사용할 Unit ID (이하
YOUR_INTERSTITIAL_UNIT_ID
)
2 단계. 광고 할당 및 표시하기
인터스티셜 지면에 광고를 할당받고 표시하려면 다음의 절차를 따르세요.
- 인터스티셜 UI 타입을 결정한 후
BuzzAdInterstitial
을 생성하세요.
- 다이얼로그 UI:
BuzzAdInterstitial.Builder().buildDialog()
를 호출하세요. - 바텀 시트 UI:
BuzzAdInterstitial.Builder().buildBottomSheet()
를 호출하세요.
load()
를 호출하여 광고를 할당받으세요.show(context)
를 호출하여 광고를 표시하세요.final BuzzAdInterstitial buzzAdInterstitial =
new BuzzAdInterstitial.Builder("YOUR_INTERSTITIAL_UNIT_ID")
.buildDialog();
buzzAdInterstitial.load(new InterstitialAdListener() {
@Override
public void onAdLoaded() {
// 할당된 광고가 있으면 호출됩니다.
// Interstitial 광고를 화면에 표시합니다.
buzzAdInterstitial.show(activityContext);
}
@Override
public void onAdLoadFailed(@Nullable AdError adError) {
// 할당된 광고가 없으면 호출됩니다.
Log.e(TAG, "Failed to load a interstitial ad.", adError);
}
@Override
public void onAdClosed() {
super.onAdClosed();
// Interstitial 지면이 종료되면 호출됩니다.
// 필요에 따라 추가 기능을 구현하세요.
}
});
✏️ 참고
할당된 광고가 없을 때에는AdError
의errorMessage
가 empty response로 전달되고, 광고가 노출되지 않습니다. 광고 미할당 시 발생하는 오류 코드에 대한 자세한 내용은 오류 코드가 나타납니다 토픽을 참고하세요.
3 단계. 인터스티셜에 피드 진입 경로 추가하기
인터스티셜 지면에서 피드 지면으로 이동할 수 있는 진입 경로(엔트리 포인트)를 추가하세요.
✏️ 참고
아래의 작업을 완료한 후 추가해야 합니다.
- 인터스티셜 지면 기본 설정
- 피드 지면 기본 설정
- 피드 연동에 사용한
YOUR_FEED_UNIT_ID
확인
인터스티셜 지면에는 피드 지면으로 유도하기 위한 진입 유도 문구가 보입니다. 유도 문구를 클릭 시, setDefaultFeedConfig()
로 설정한 FeedConfig
객체를 이용하여 Feed 지면이 표시됩니다. 다른 FeedConfig
를 사용하려는 경우에는 다음에 따라 설정하세요. 단, 진입 경로 레이아웃은 변경할 수 없습니다.
FeedConfig
를 새로 생성하세요.1번 단계에서 만든
FeedConfig
를 이용하여BuzzAdNavigator
인스턴스를 생성하세요.BuzzAdNavigator
인스턴스를BuzzAdInterstitial.buzzAdNavigator()
에 추가하여FeedConfig
를 변경하세요.final FeedConfig feedConfig = new FeedConfig.Builder("YOURD_FEED_UNIT_ID").build();
final BuzzAdNavigator feedNavigator = BuzzAdFeed.createFeedNavigator(feedConfig);
final BuzzAdInterstitial buzzAdInterstitial =
new BuzzAdInterstitial.Builder("YOUR_INTERSTITIAL_UNIT_ID")
.buzzAdNavigator(feedNavigator)
.buildDialog();
유도 문구 색상 변경하기
주요 UI의 색상(Primary color)을 변경할 수 있는 GlobalTheme
을 사용해 진입 경로 레이아웃의 Feed 진입 유도 문구 색상을 변경할 수 있습니다. 자세한 내용은 전체 테마 변경하기 토픽을 참고하세요.
4 단계. 기본 연동 테스트하기
모든 기본 연동 단계를 완료한 후 광고가 정상적으로 할당되고 표시되는지 확인하세요. 그리고 피드 진입 경로가 제대로 동작하여 클릭하면 피드로 이동하는지 확인하세요.