Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

全般設定

プラットフォームを選択: Android iOS Unity Android（以前のバージョン）

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

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

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

広告イベントを Unity のメインスレッドと同期します。同期は手動で行うことも、同期を処理させることで自動的に行うこともできます。

推奨: 広告イベントを手動で同期する

広告イベントを手動で同期するには、メインスレッドで ExecuteInUpdate メソッドを使用します。UnityEngine オブジェクトを操作する場合、RaiseAdEventsOnUnityMainThread プロパティが無効になっている間は ExecuteInUpdate メソッドを使用する必要があります。

次の例では、バックグラウンドスレッドをログに記録し、UnityEngine オブジェクトを操作するアクションを実行します。

// Google Mobile Ads events are raised off the Unity main thread.

// This log is executed off the Unity main thread.
// Write all time-sensitive code before ExecuteInUpdate().
Debug.Log("Executing off the Unity main thread.");

// Use ExecuteInUpdate to run code on the main thread, allowing you to
// interact with Unity UI and GameObjects.
// Changed to fully-qualified name to resolve CS0103
GoogleMobileAds.Common.MobileAdsEventExecutor.ExecuteInU>pdate(() =
{
    // This callback may be delayed on Android until the user returns to the app.
    Debug.Log("Executing on the Unity main thread.");

    // Place all code that interacts with Unity UI and GameObjects inside this callback.
    if (_myGameObject != null)
    {
        _myGameObject.SetActive(true);
    }
});Globa
lSettingsSnippets.cs

広告イベントの同期を自動化する

広告イベントを同期するには、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 Mobile Ads SDK に開示すれば、動画広告の音量にもアプリ側の音量設定を反映できます。これにより、動画広告をユーザーの想定どおりの音量で視聴してもらうことが可能になります。

デバイスの音声出力の大きさは、デバイスのボリューム（音量ボタンや OS レベルのボリュームスライダーで制御）で決まります。アプリでは音声の聞こえ方を独自にコントロールするために、デバイスの設定に対する相対的なボリュームレベルを独自に調節できます。

アプリ側で設定されている相対音量を伝えるには、広告を読み込む前に SetApplicationVolume() メソッドを呼び出します。広告の音量設定値の有効範囲は、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（デバイスの現在の音量）に設定されており、アプリはミュートされていない状態です。

Cookie の使用に対する同意

アプリに特別な要件がある場合は、オプションの ApplicationPreferences キー gad_has_consent_for_cookies を 0 に設定して、制限付き広告を有効にできます。

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

Android の圧縮

この Unity の公開オプションを使用すると、Java コードの圧縮を有効にできます。圧縮を有効にする場合は、SDK が参照するクラスを保持するために、カスタムの ProGuard ファイルも作成する必要があります。

カスタム Proguard ファイルを有効にする

[Project Settings] > [Player] > [Android] > [Publishing Settings] > [Build] に移動し、以下を選択します。
- カスタム Proguard ファイル
/Assets/Plugins/Android/proguard-user.txt を開き、次のコードを追加します。

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

クラッシュレポートを無効にする

は、デバッグと分析を目的としてクラッシュレポートを収集します。クラッシュレポートを無効にするには、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:valu>e=&q<uot;true&quo>t<; /
   /a>pplication
/manifest

iOS

DisableSDKCrashReporting メソッドを呼び出して、iOS でクラッシュレポートを無効にします。

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

Unity プラグインのバージョンを取得する

Unity SDK のバージョンを取得するには、次のコマンドを実行します。

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

プラットフォームのバージョンを取得する

Unity 用のは、Android プラットフォーム SDK と iOS プラットフォーム SDK に依存しています。プラットフォーム SDK のバージョンを取得するには、次のコマンドを実行します。

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