[Unity3D] Unity Ads 연동하기

이번에는 Unity 프로젝트에 Unity Ads를 연동해보겠습니다. (매우 간단 주의)

우선 Unity에서 [Window -> Services] 하면 인스펙터 뷰 옆에 아래와 같은 화면이 나타나는데

Ads 항목이 OFF(디폴트)로 되어있는 것을 볼 수 있습니다.

Ads 항목을 클릭하면 아래와 같이 나오는데

토글 버튼을 눌러 비활성화되어있는 Ads를 활성화 시킵니다.

13세 미만 아이들에게 지도감독이 필요한 앱인지 여부를 설정하고 Continue 합니다.

활성화가 완료되면 아래와 같이 나옵니다.

원하는 Platform을 체크합니다.

Enable test mode를 체크하면 유니티에서 제공하는 짧은 테스트 광고영상만 송출됩니다.

(런칭 시 반드시 위 항목 체크를 해제할 것)

여기까지 완료했다면, 

using UnityEngine.Advertisements; 

를 할수있게 됩니다!

UnityAdsHelper라는 C# 스크립트를 하나 생성하고

아래의 코드를 복사해서 붙여 넣습니다.

그 다음, 빈 게임 오브젝트를 하나 생성하고 UnityAdsHelper.cs를 AddComponent 해줍니다.

using UnityEngine;
using UnityEngine.Advertisements;
 
public class UnityAdsHelper : MonoBehaviour
{
    private const string android_game_id = "xxxxxxx";
    private const string ios_game_id = "xxxxxxx";
 
    private const string rewarded_video_id = "rewardedVideo";
 
    void Start()
    {
        Initialize();
    }
 
    private void Initialize()
    {
#if UNITY_ANDROID
        Advertisement.Initialize(android_game_id);
#elif UNITY_IOS
        Advertisement.Initialize(ios_game_id);
#endif
    }
 
    public void ShowRewardedAd()
    {
        if (Advertisement.IsReady(rewarded_video_id))
        {
            var options = new ShowOptions { resultCallback = HandleShowResult };
 
            Advertisement.Show(rewarded_video_id, options);
        }
    }
 
    private void HandleShowResult(ShowResult result)
    {
        switch (result)
        {
            case ShowResult.Finished:
                {
                    Debug.Log("The ad was successfully shown.");
 
                    // to do ...
                    // 광고 시청이 완료되었을 때 처리
 
                    break;
                }
            case ShowResult.Skipped:
                {
                    Debug.Log("The ad was skipped before reaching the end.");
 
                    // to do ...
                    // 광고가 스킵되었을 때 처리
 
                    break;
                }
            case ShowResult.Failed:
                {
                    Debug.LogError("The ad failed to be shown.");
 
                    // to do ...
                    // 광고 시청에 실패했을 때 처리
 
                    break;
                }
        }
    }
}
 

위 코드는

ShowRewardedAd() 함수로 비디오 광고 송출 요청을 하고

HandleShowResult 콜백으로 요청 결과에 따라 Finished, Skipped, Failed 처리하는 구조로 되어있습니다.

* 여기서 androiod game id와 ios game id 그리고 rewarded video id가 필요한데

Services의 우측 상단에 있는 Go to Dashboard 를 누르면

아래와 같은 화면이 뜨는데

여기서 android 게임 ID와 ios 게임 ID를 확인할 수 있습니다.

UnityAdsHelper.cs의 android_game_id 변수와 ios_game_id 변수에 Game Id 숫자 7자리를 각각 넣어주시면 됩니다.

그 다음, 구글 플레이 스토어 또는 애플 앱 스토어 플랫폼을 클릭하여 Ad placements 정보를 확인합니다.

기본적으로 Video와 Rewarded Video 두 가지가 생성되어있는데

첫 번째에 있는 Video는 Skip이 가능한 광고이고

두 번째에 있는 Rewarded Video는 Skip이 불가능한 보상형 광고입니다. 

수익을 많이 내려면 당연히 Skip이 불가능한 보상형 광고를 써야겠죠?

위 스크린샷 처럼 Rewarded Video를 Enabled 하고 Default로 설정합니다. (우측에 EDIT 버튼으로 세부설정이 가능함)

그리고 Rewarded Video의 PLACEMENT ID를 복사하여

UnityAdsHelper.cs의 rewarded_video_id 변수에 넣어줍니다.

----------------------------------------------------------------------------------

자, 모든 준비가 끝났습니다!

Unity Editor에서 ShowRewardedAd()로 광고를 요청했을 때 아래와 같은 화면이 나온다면

정상적으로 연동된 것입니다.

이제 원하는 상황에 ShowRewardedAd() 함수를 호출하고 (주로 게임 오버될 때 혹은 특정 버프를 받을 때)

HandleShowResult 콜백에서 원하는 처리를 하여 마무리해줍니다. (캐릭터 부활 혹은 버프효과 적용 등)