Android용 인터스티셜 광고 광고 유닛 API 마이그레이션
앱 키로 SDK를 초기화하고 특정 광고 유닛 ID로 재사용 가능한 인터스티셜 광고 오브젝트를 생성하고, 로딩, 표시, 닫기와 같은 광고 이벤트를 처리하기 위해 리스너를 구현하여 레벨플레이 인터스티셜 광고 유닛 API로 마이그레이션할 수 있습니다.
읽는 시간 4분최근 업데이트: 14시간 전
이 가이드에서는 현재 구현에서 광고 유닛 ID를 사용하여 레벨플레이 인터스티셜 광고 API로 전환 인터스티셜 광고 로드하고 표시하는 방법을 설명합니다.
필수 조건
- 최소 지원 SDK는 8.6.0입니다. 최신 SDK는 여기에서 다운로드할 수 있습니다.
- 레벨플레이 초기화 API 사용하여 SDK를 초기화해야 합니다.
- 레벨플레이 대시보드에서 AdUnitID를 찾습니다.
인터스티셜 광고 오브젝트 생성
인터스티셜 광고 오브젝트의 생성은 onInitSuccess 콜백을 수신한 후에 수행해야 합니다.
오브젝트 세션 전체에 걸쳐 여러 로드와 표시를 처리할 수 있는 재사용 가능한 인스턴스. 생성 후에는 동일한 광고 유닛의 광고를 로드하고 표시하는 데 사용해야 합니다.
더 고급 구현을 위해 필요한 경우 여러 개의 인터스티셜 광고 객체를 생성할 수 있습니다.
// 인터스티셜 광고 만들기mInterstitialAd = new LevelPlayInterstitialAd("adUnitId");
인터스티셜 광고 이벤트 등록
광고 전송에 대해 알리기 위해 LevelPlayInterstitialListener 대신 코드에 LevelPlayInterstitialAdListener를 구현하십시오.
- 인터스티셜 광고 광고를 로드하기 전에 리스너를 설정하는 것이 좋습니다.
- 각 인터스티셜 광고 광고에는 고유한 리스너 구현이 있어야 합니다.
- 콜백은 메인 스레드 실행됩니다.
// 인터스티셜 광고 만들기mInterstitialAd = new LevelPlayInterstitialAd("adUnitId");// 리스너 설정mInterstitialAd.setListener(this);// LevelPlayInterstitialAdListener methods@Overridepublic void onAdLoaded(@NonNull LevelPlayAdInfo adInfo) {}@Overridepublic void onAdLoadFailed(@NonNull LevelPlayAdError error) {}@Overridepublic void onAdDisplayed(@NonNull LevelPlayAdInfo adInfo) {}@Overridepublic void onAdDisplayFailed(@NonNull LevelPlayAdError error, @NonNull LevelPlayAdInfo adInfo) {}@Overridepublic void onAdClosed(@NonNull LevelPlayAdInfo adInfo) {}@Overridepublic void onAdClicked(@NonNull LevelPlayAdInfo adInfo) {}@Overridepublic void onAdInfoChanged(@NonNull LevelPlayAdInfo adInfo) {}
레거시 | 광고 단위(신규) | |
|---|---|---|
| 청자 | LevelPlayInterstitialListener | LevelPlayInterstitialAdListener |
| 콜백 | onAdReady | onAdLoaded |
| onAdLoadFailed | onAdLoadFailed | |
| onAdOpened | onAdDisplayed | |
| onAdClosed | onAdClosed | |
| onAdShowFailed | onAdDisplayFailed | |
| onAdClicked | onAdClicked | |
| onAdShowSucceeded | - (사용 중단 예정) | |
| onAdInfoChanged |
레벨플레이 광고 정보
참고
인터스티셜 광고 리스너 콜백이 반환하는 AdInfo 클래스 LevelPlayAdInfo로 대체되었습니다.
인터스티셜 광고 로드
인터스티셜 광고를 로드하려면 loadInterstitial 대신 loadAd를 사용합니다.
// 광고를 로드하거나 다시 로드합니다.mInterstitialAd.loadAd();
인터스티셜 광고 표시
LevelPlayInterstitialAdListener API를 사용하여 onAdLoaded 콜백을 수신한 후 인터스티셜 광고를 표시합니다.
- 공유하는 데 필요한 활동입니다.
- 플레이스먼트를 사용하는 경우 아래의 Placements 섹션 같이 showAd API 플레이스먼트 이름을 전달.
- 광고가 사용자 성공적으로 표시되면 로딩 단계를 반복하여 다른 광고를 로드할 수 있습니다.
// 플레이스먼트 없이 광고 표시mInterstitialAd.showAd(this);// 플레이스먼트가 있는 광고 표시mInterstitialAd.showAd(this, placementName);
광고가 준비되었는지 확인
표시 실패를 방지하고 광고가 올바르게 표시되었는지 확인하기 위해 showAd API를 호출하기 전에 다음 API를 사용하는 것이 좋습니다.
isAdReady – 광고가 성공적으로 로드되고 광고 유닛이 제한되지 않거나 거짓이 아닌 경우 true를 반환합니다.
isPlacementCapped – 유효한 플레이스먼트가 제한되면 true를 반환합니다. 플레이스먼트가 유효하지 않거나 제한이 없는 경우 이 API false를 반환합니다.
// 광고가 준비되었는지, 플레이스먼트가 제한되지 않았는지 확인합니다.if (mInterstitialAd.isAdReady() && !LevelPlayInterstitialAd.isPlacementCapped(placementName)) { mInterstitialAd.showAd(this, placementName);}
Placements
레벨플레이 대시보드에서 인터스티셜 광고의 플레이스먼트 속도와 한도를 지원합니다.
인터스티셜 광고에 대한 플레이스먼트가 설정된 경우 특정 플레이스먼트에 광고를 게재하려면 showAd 메서드를 호출합니다.
// 광고가 준비되었는지, 플레이스먼트가 제한되지 않았는지 확인합니다.if (mInterstitialAd.isAdReady() && !LevelPlayInterstitialAd.isPlacementCapped(placementName)) { // 플레이스먼트가 있는 광고 표시 mInterstitialAd.showAd(this, placementName);}
여러 광고 유닛 인터스티셜 광고 API
레거시 | 광고 단위(신규) | |
|---|---|---|
| API | loadInterstitial | loadAd |
| showInterstitial | showAd | |
| isInterstitialPlacementCapped | LevelPlayInterstitialAd.isPlacementCapped | |
| isInterstitialReady | isAdReady |
인터스티셜 광고 전체 구현 예시
공용 클래스 InterstitialAdActivity 확장 활동 구현 LevelPlayInterstitialAdListener { private LevelPlayInterstitialAd mInterstitialAd; void createInterstitialAd() { mInterstitialAd = new LevelPlayInterstitialAd("adUnitId"); mInterstitialAd.setListener(this); } void loadInterstitialAd() { mInterstitialAd.loadAd(); } void showInterstitialAd() { if (mInterstitialAd.isAdReady()) { mInterstitialAd.showAd(this); } } void showInterstitialAd(@NonNull String placementName) { if (mInterstitialAd.isAdReady() && !LevelPlayInterstitialAd.isPlacementCapped(placementName)) { mInterstitialAd.showAd(this, placementName); } } // LevelPlayInterstitialAdListener methods @Override public void onAdLoaded(@NonNull LevelPlayAdInfo adInfo) {} @Override public void onAdLoadFailed(@NonNull LevelPlayAdError error) {} @Override public void onAdDisplayed(@NonNull LevelPlayAdInfo adInfo) {} @Override public void onAdClosed(@NonNull LevelPlayAdInfo adInfo) {} @Override public void onAdClicked(@NonNull LevelPlayAdInfo adInfo) {} @Override public void onAdDisplayFailed(@NonNull LevelPlayAdError error, @NonNull LevelPlayAdInfo adInfo) {} @Override public void onAdInfoChanged(@NonNull LevelPlayAdInfo adInfo) {}}
완료!
이제 새로운 다중 광고 유닛 API를 사용하여 애플리케이션 인터스티셜 광고 게재할 수 있습니다.