기술 자료

Unity Ads Monetization


Android API 참조

Unity Ads Monetization


Android에서 보상형 광고 구현

Android 앱에서 보상형 광고를 구현합니다. 광고 콘텐츠를 로드하고 Java 코드를 통해 표시하고 리스너를 사용하여 광고 이벤트와 보상 로직을 관리합니다.
읽는 시간 2분최근 업데이트: 한 달 전

광고를 보는 사용자에게 보상을 제공하면 사용자 참여가 증가하고 더욱 높은 수익으로 이어질 수 있습니다. 예를 들어, 게임 내 재화나 소모품, 추가 생명, 경험치 증가 등의 보상을 게임에서 사용자에게 제공할 수 있습니다. 보상형 광고를 효과적으로 설계하는 방법에 관한 자세한 내용은 수익화 전략 가이드를 참고하십시오.

보상형 동영상 광고 로드 예제

유지된
show()
인스턴스에서
RewardedAd
을 호출하여 액티비티,
ShowConfiguration
,
RewardedShowListener
을 전달합니다. 리스너는 표준 광고 수명 주기 이벤트를 위한
onStarted
,
onClicked
,
onFailed
콜백과 두 가지 보상 관련 콜백을 제공합니다.
onRewarded
은(는) 사용자가 보상을 획득할 때 실행되고,
onCompleted
은(는) 그 후 광고가 닫힐 때 실행됩니다. 두 콜백이 순차적으로 실행될 수 있으므로, 보상 로직은 일반적으로
shouldAlwaysRewardUser()
과(와) 같은 플래그를 확인하여 보상이 두 번 지급되지 않도록 둘 중 하나에서만 처리해야 합니다.
광고는 로드된 후 표시되지 않으면 일정 시간이 지나면 만료됩니다. 이를 감지하려면 로드된 광고 인스턴스에
onAdExpired
을(를) 설정하십시오. 이는 보상형 광고가 종종 미리 로드되어 사용자가 옵트인할 때까지 보관되기 때문에 특히 중요합니다. 만료된 광고에서
show()
을(를) 호출하면 실패하므로, 콜백을 사용하여 저장된 참조를 지우고 새로운
load()
호출을 실행하여 필요할 때 새로운 광고가 준비되도록 하십시오.
RewardedAd.load(loadConfig, (rewardedAd, error) -> { if (rewardedAd != null) { // 광고가 성공적으로 로드되었으며, 표시할 준비가 되었습니다 this.rewardedAd = rewardedAd; rewardedAd.setOnAdExpired(expiredAd -> { this.rewardedAd = null; // 여기에 다시 로드 }); } else { // 로드 오류 처리 }});

보상형 동영상 광고 표시 예제

rewardedAd.show(activity, showConfig, rewardedAdShowListener){ @Override public void onStarted(@NonNull InterstitialAd ad) { /* 표시됨 */ } @Override public void onClicked(@NonNull InterstitialAd ad) { /* 클릭됨 */ } @Override public void onCompleted(@NonNull InterstitialAd ad, @NonNull ShowFinishState state) { /* 숨김 */ } @Override public void onFailed(@NonNull InterstitialAd ad, @NonNull UnityAdsError error) { /* 실패 */ } }
다음 단계: Android에서 배너 광고 구현을 참조하십시오.