전체 설정

MobileAds 클래스는 Google 모바일 광고 SDK의 전체 설정을 제공합니다.

Unity 기본 스레드에서 광고 이벤트 발생

Google 모바일 광고 SDK는 Unity 기본 스레드와 다른 스레드에서 이벤트를 발생시킵니다. 광고 이벤트를 구현하고 Unity 객체와 상호작용하는 경우 모바일 광고 SDK 이벤트를 Unity 기본 스레드와 동기화해야 합니다.

Google 모바일 광고 SDK가 동기화를 처리하도록 하여 광고 이벤트를 Unity 기본 스레드와 수동 또는 자동으로 동기화합니다.

광고 이벤트 수동 동기화

광고 이벤트를 동기화하려면 기본 스레드에서 ExecuteInUpdate 메서드를 수동으로 사용하세요. RaiseAdEventsOnUnityMainThread 속성이 사용 중지되고 UnityEngine 객체와 상호작용하는 경우 이 메서드를 사용해야 합니다.

다음 예에서는 백그라운드 스레드를 로깅하고 UnityEngine 객체와 상호작용하는 작업을 실행합니다.

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
    });
};

광고 이벤트에서 동기화 자동화

Google 모바일 광고 SDK가 광고 이벤트를 동기화하도록 하려면 MobileAds.RaiseAdEventsOnUnityMainThread 속성을 true로 설정하세요.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

동영상 광고 볼륨 조절

앱에 자체적인 볼륨 조절 기능(예: 맞춤 음악 또는 음향효과 볼륨)이 있는 경우, Google 모바일 광고 SDK에 앱 볼륨 정보를 공개하면 동영상 광고에 앱 볼륨 설정을 적용할 수 있습니다. 이를 통해 사용자가 놀라지 않는 범위의 오디오 볼륨으로 동영상 광고가 게재됩니다.

볼륨 버튼 또는 OS 수준 볼륨 슬라이더를 통해 조절되는 기기 볼륨은 기기 오디오 출력 볼륨을 결정합니다. 그러나 앱의 경우 기기 볼륨에 대한 비율로 정의되는 자체 볼륨을 조절해 오디오 환경을 맞춤설정할 수 있습니다.

광고를 로드하기 전에 SetApplicationVolume() 메서드를 호출하여 Google 모바일 광고 SDK에 상대적인 앱 볼륨을 보고할 수 있습니다. 유효한 광고 볼륨 값의 범위는 0.0 (무음)~1.0 (현재 기기 볼륨)입니다. 다음은 SDK에 상대적인 앱 볼륨을 보고하는 방법의 예입니다.

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

SDK에 앱 볼륨이 음소거되었음을 알리려면 광고를 로드하기 전에 SetApplicationMuted() 메서드를 호출하세요.

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

기본적으로 앱 볼륨은 현재 기기 볼륨인 1로 설정되며 앱은 음소거되지 않습니다.

쿠키에 대한 동의

앱에 특별한 요구사항이 있는 경우 선택사항인 ApplicationPreferences 키 gad_has_consent_for_cookies를 0으로 설정하여 제한적인 광고 (LTD)를 사용 설정할 수 있습니다.

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Android 축소

이 Unity 게시 옵션을 사용하면 Java 코드 축소를 사용 설정할 수 있습니다. 축소 기능을 사용 설정하는 경우 SDK에서 참조하는 클래스를 유지하기 위해 맞춤 Proguard 파일을 만들어야 합니다.

1. 맞춤 Proguard 파일 사용 설정

   Project Settings(프로젝트 설정) > Player(플레이어) > Android > Publishing Settings(게시 설정) > Build(빌드)로 이동하여 다음을 선택합니다.

   • 맞춤 Proguard 파일

2. /Assets/Plugins/Android/proguard-user.txt를 열고 다음을 추가합니다.

-keep class com.google.** { public *; }

비정상 종료 보고 사용 중지

Google 모바일 광고 SDK는 디버깅 및 분석 목적으로 비정상 종료 보고서를 수집합니다. 다음 코드를 사용하여 이 비정상 종료 보고를 사용 중지할 수 있습니다. 다음 섹션에서는 Android 및 iOS에서 비정상 종료 보고를 사용 중지하는 방법을 설명합니다.

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}

Unity 플러그인 버전 가져오기

Unity SDK 버전을 가져오려면 다음을 실행합니다.

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

플랫폼 버전 가져오기

Unity용 Google 모바일 광고 SDK는 Android 및 iOS 플랫폼 SDK에 종속됩니다. 플랫폼 SDK 버전을 가져오려면 다음을 실행합니다.

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());