전체 설정

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

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

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

모바일 광고 SDK에서 이 스레딩 문제를 처리하도록 하려면 MobileAds.RaiseAdEventsOnUnityMainThread를 true로 설정하세요. 이렇게 하면 SDK가 Unity 기본 스레드에서 모든 이벤트와 콜백을 발생시킵니다.

...
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에서 비정상 종료 보고를 사용 중지하는 방법을 설명합니다.

Android

앱의 AndroidManifest.xml 파일에 DISABLE_CRASH_REPORTING가 true로 설정된 <meta-data> 태그를 추가합니다.

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

iOS

DisableSDKCrashReporting 메서드를 호출하여 iOS에서 비정상 종료 보고서를 사용 중지합니다.

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