보상형 광고 (유니티)

now.gg 유니티용 보상형 광고 모듈을 통해 유니티 게임 내에서 인앱 보상형 광고를 사용하실 수 있습니다.

방법:

1. now.gg 보상형 광고 유니티 모듈을 다운로드하고 임포트합니다.
2. 필수 종속성을 추가합니다.
3. 프로젝트에 now.gg 보상형 광고를 적용합니다.

모듈 다운로드 및 임포트

now.gg 보상형 광고 유니티 모듈은 유니티 패키지 파일 NowGGUnitySdk.unitypackage에 포함되어 있습니다.

Unity 프로젝트에 모듈 추가:

1. 최신 버전의 now.gg 보상형 광고 모듈(Unity용) 패키지를 다운로드합니다.
2. 이제 해당 패키지를 Unity 프로젝트에 가져옵니다. 방법은 다음과 같습니다:
   • Assets > Import Package > Custom Package를 클릭합니다.
     • 시스템에서 NowGGUnitySdk.unitypackage를 선택합니다.
   • 기본적으로 모든 모듈이 선택되어 있습니다. 필요하지 않은 모듈의 선택을 해제한 뒤, 아래와 같이 Import를 클릭합니다:
     
3. 필수 종속성 추가
   • Assets > External Dependency Manager > Android Resolver > Resolve 를 클릭합니다.
     이 작업을 통해 Unity External Dependency Manager가 필요한 모든 종속성을 다운로드하여 프로젝트의 /Assets/Plugins/Android 디렉터리에 추가합니다.

now.gg 보상형 광고 적용

다음은 유니티 앱/게임용 now.gg 보상형 광고의 샘플 코드입니다.

now.gg 보상형 광고 모듈을 임포트하고 종속성이 추가되면 앱/게임에 now.gg 보상형 광고 모듈을 적용하실 수 있습니다.

1. 초기화

앱에서 광고를 표시하려면 먼저 모듈을 초기화해야 합니다.

아래와 같이 now.gg 보상형 광고 로직을 포함하는 클래스를 생성하고 모듈을 초기화하는 데 사용할 수 있는 게임 오브젝트에 추가합니다.

void Start()
   {
       NowGGAdsManager.Instance.OnInitSuccess += OnInitSuccess;
       NowGGAdsManager.Instance.OnInitFailed += OnInitFailed;
       NowGGAdsManager.Instance.OnNowGGRewardedAdDismissed += OnAdDismissed;
       NowGGAdsManager.Instance.OnNowGGRewardedAdFailedToLoad += OnAdFailedToLoad;
       NowGGAdsManager.Instance.OnNowGGRewardedAdShownToUser += OnAdShownToUser;
       NowGGAdsManager.Instance.OnUserEarnedReward += OnUserEarnedReward;
      
       NowGGAdsManager.Instance.Initialize();
   }

중요:

• SDK 모듈은 실행 시 한 번만 초기화합니다.
• NowGGAdsManager 클래스의 Initialize()를 호출하여 보상형 광고를 초기화합니다.
• 모듈의 응답 메시지는 위에 설명된 대로 콜백 함수를 사용하여 처리됩니다.

2. 보상형 광고 표시

모듈이 성공적으로 초기화되면 인앱 보상형 광고를 표시하실 수 있습니다.

이때 NowGGAdsManager.Instance.ShowRewardedAd()를 호출하여 앱에 보상형 광고를 표시합니다.

now.gg 보상형 광고는 다음 콜백 함수를 활용하여 앱에 보상형 광고 요청 상태를 알립니다.

• void OnAdShownToUser(); – 유저 화면에 광고가 표시됩니다.
• void OnAdFailedToLoad(String error); – 광고를 로드하지 못했습니다.
• void OnAdDismissed(bool rewardEarned); – 유저가 광고를 닫았습니다. 진행되던 앱 프로세스로 돌아옵니다.
  • 사용자가 광고를 조기에 닫은 경우 rewardEarned는 False가 됩니다.
  • 광고가 보상을 획득하는 데 필요한 재생 시간을 완료하면 rewardEarned는 True가 됩니다.
• void OnUserEarnedReward(); – 유저가 보상을 받았습니다.

다음 코드는 위에 나열된 콜백 함수의 예입니다.

public class RewardsSDKDemo : MonoBehaviour
{
   
// 광고 표시   
   public void ShowAd()
   {
       NowGGAdsManager.Instance.ShowRewardedAd();
   }

// 초기화 성공
   private void OnInitSuccess()
   {
       Debug.Log("OnInitSuccess");
   }

// 초기화 실패
   private void OnInitFailed(string error)
   {
       Debug.Log("OnInitFailed.. " + error);
   }

// 유저 화면에 광고가 표시됩니다.
   private void OnAdShownToUser()
   {
       Debug.Log("OnAdShownToUser");
   }

// 광고를 로드하지 못했습니다.
   private void OnAdFailedToLoad(string error)
   {
       Debug.Log("OnAdFailedToLoad.." + error);
   }

// 유저가 광고를 닫았습니다. 진행되던 앱 프로세스로 돌아옵니다.
   private void OnAdDismissed(bool rewardEarned)
   {
       Debug.Log("OnAdDismissed.." + rewardEarned);
   }

// 유저가 보상을 받았습니다.
   private void OnUserEarnedReward()
      {
          Debug.Log("OnUserEarnedReward");
      }
}