보상형 광고

보상형 광고는 사용자에게 상호작용에 대한 대가로 인앱 리워드를 제공하는 광고입니다. 이 가이드에서는 AdMob의 보상형 광고를 Unity 앱에 통합하는 방법을 설명합니다.

고객 성공사례를 읽어보세요. 우수사례 1, 우수사례 2

이 가이드에는 보상형 광고를 Unity 앱에 통합하는 방법이 나와 있습니다.

기본 요건

• 시작 가이드에 따라 필요한 과정을 완료합니다.

항상 테스트 광고로 테스트합니다

아래 샘플 코드에는 테스트 광고 요청에 사용할 수 있는 광고 단위 ID가 포함되어 있습니다. 이 ID는 모든 요청에 대해 실제 광고가 아닌 테스트 광고를 반환하도록 구성되어서 안전하게 사용할 수 있습니다.

그러나 AdMob 웹 인터페이스에 앱을 등록하고 앱에서 사용할 광고 단위 ID를 직접 생성한 후에는 개발 중에 명확하게 기기를 테스트 기기로 설정하세요.

모바일 광고 SDK 초기화

광고를 로드하기 전에 앱이 MobileAds.Initialize()를 호출하여 모바일 광고 SDK를 초기화하게 하세요. 이 작업은 앱 실행 시 한 번만 처리하면 됩니다.

using GoogleMobileAds;
using GoogleMobileAds.Api;

public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize((InitializationStatus initStatus) =>
        {
            // This callback is called once the MobileAds SDK is initialized.
        });
    }
}

미디에이션을 사용하는 경우 광고 로드 전에 콜백이 발생할 때까지 기다려야 모든 미디에이션 어댑터가 초기화됩니다.

보상형 광고 로드

보상형 광고는 RewardedAd 클래스의 정적 Load() 메서드를 이용해 로드됩니다. 로드된 RewardedAd 객체는 완료 핸들러의 매개변수로 제공됩니다. 다음 예에서는 보상형 광고를 로드합니다.

AD_UNIT_ID를 광고 단위 ID로 바꿉니다.

[선택사항] 서버 측 확인(SSV) 콜백 검사

서버 측 확인 콜백에서 추가 데이터가 필요한 앱은 보상형 광고의 맞춤 데이터 기능을 사용해야 합니다. 보상형 광고 객체에 설정된 모든 문자열 값은 SSV 콜백의 custom_data 쿼리 매개변수에 전달됩니다. 맞춤 데이터 값이 설정되지 않은 경우 custom_data 쿼리 매개변수 값은 SSV 콜백에 표시되지 않습니다.

다음 코드 샘플은 보상형 광고가 로드된 후 SSV 옵션을 설정하는 방법을 보여줍니다.

SAMPLE_CUSTOM_DATA_STRING을 맞춤 데이터로 바꿉니다.

맞춤 보상 문자열을 설정하려면 광고를 게재하기 전에 해야 합니다.

리워드 콜백으로 보상형 광고 표시

광고를 표시할 때 사용자의 보상을 처리할 콜백을 제공해야 합니다. 광고는 로드당 한 번만 게재될 수 있습니다. CanShowAd() 메서드를 사용하여 광고를 게재할 준비가 되었다는 것을 확인하세요.

다음 코드는 보상형 광고를 게재하기 위한 최적의 메서드를 나타냅니다.

if (rewardedAd != null && rewardedAd.CanShowAd()) { rewardedAd.Show((Reward reward) => { // 광고가 표시되었으며 사용자가 보상을 받았습니다. }); }

보상형 광고 이벤트 수신 대기

광고의 작동 방식을 더 세부적으로 맞춤설정하려는 경우 광고의 수명 주기에서 여러 이벤트에 연결하면 됩니다. 다음 코드는 광고 이벤트를 수신 대기합니다.

rewardedAd.OnAdPaid += (AdValue adValue) => { // 광고에서 수익이 창출되었다고 추정될 때 발생합니다. }; rewardedAd.OnAdImpressionRecorded += () => { // 광고 노출이 기록되었을 때 발생합니다. }; rewardedAd.OnAdClicked += () => { // 광고 클릭이 기록되었을 때 발생합니다. }; rewardedAd.OnAdFullScreenContentOpened += () => { // 광고가 전체 화면 콘텐츠를 열었을 때 발생합니다. }; rewardedAd.OnAdFullScreenContentClosed += () => { // 광고가 전체 화면 콘텐츠를 닫았을 때 발생합니다. }; rewardedAd.OnAdFullScreenContentFailed += (AdError error) => { // 광고가 전체 화면 콘텐츠를 열지 못했을 때 발생합니다. };

보상형 광고 정리

RewardedAd 사용이 끝나면 참조를 삭제하기 전에 Destroy() 메서드를 호출해야 합니다.

if (rewardedAd != null) { rewardedAd.Destroy(); }

이렇게 하면 객체가 더 이상 사용되지 않는다는 것을 플러그인에게 알려 객체가 사용한 메모리를 복구할 수 있습니다. 이 메서드를 호출하지 않으면 메모리 누수가 발생합니다.

다음 보상형 광고 미리 로드

RewardedAd는 일회용 객체입니다. 즉, 보상형 광고가 표시된 후에는 이 객체를 다시 사용할 수 없습니다. 다른 보상형 광고를 요청하려면 새 RewardedAd 객체를 만들어야 합니다.

다음 노출 기회에 보상형 광고가 게재되도록 OnAdFullScreenContentClosed 또는 OnAdFullScreenContentFailed 광고 이벤트가 발생한 후에 보상형 광고를 미리 로드합니다.

추가 리소스

• HelloWorld 예시: 모든 광고 형식의 최소 구현입니다.