全般設定

MobileAds クラスは、Google Mobile Ads SDK のグローバル設定を提供します。

Unity のメインスレッドで広告イベントを発生させる

Google Mobile Ads SDK は Unity のメインスレッドとは異なるスレッドでイベントを生成します。広告イベントを実装して Unity オブジェクトを操作する場合は、Mobile Ads SDK イベントを Unity メインスレッドと同期する必要があります。

このスレッドの懸念を Mobile Ads 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 Mobile Ads SDK にアプリの音量を開示すると、動画広告でアプリの音量設定が考慮されます。これにより、予想される音量で動画広告をユーザーに配信できるようになります。

デバイスの音量は、音量ボタンまたは OS レベルの音量スライダーで制御され、デバイスの音声出力の音量を決定します。ただし、アプリはオーディオ エクスペリエンスを調整するために、デバイスの音量に対する音量レベルを個別に調整できます。

SetApplicationVolume() メソッドを呼び出すと、相対的なアプリ ボリュームを Google Mobile Ads 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 をゼロに設定して、制限付き広告（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 *; }