全般設定

プラットフォームを選択: Android iOS Unity

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

動画広告の音量調整

アプリに独自の音量調節機能（音楽や効果音のカスタム音量設定など）が備わっている場合、アプリの音量設定を Google Mobile Ads SDK に開示すれば、動画広告の音量にもアプリ側の音量設定を反映できます。これにより、動画広告をユーザーの想定どおりの音量で視聴してもらうことが可能になります。

デバイスの音声出力の大きさは、デバイスのボリューム（ボリューム ボタンや OS レベルのボリューム スライダーで制御）で決まります。ただし、音声の聞こえ方を独自にコントロールするために、デバイスの設定に対する相対的な音量レベルをアプリ側で独自に調節できます。アプリ起動、バナー、インタースティシャル、リワード、リワード インタースティシャルの各広告フォーマットでは、静的メソッド setAppVolume() を使用して、相対的なアプリのボリュームを SDK にレポートできます。広告の音量設定値の有効範囲は、0.0（無音）から 1.0（デバイスの現在の音量）までです。アプリ側の相対音量設定を SDK に伝えるコードは、たとえば次のようになります。

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize Google Mobile Ads SDK on a background thread.
    MobileAds.initialize(this@MainActivity) {}
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f)
  }
}

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);

  new Thread(
          () -> {
            // Initialize Google Mobile Ads SDK on a background thread.
            MobileAds.initialize(this, initializationStatus -> {});
            
            // Set app volume to be half of current device volume.
            MobileAds.setAppVolume(0.5f);
          })
      .start();
}

アプリ側で音声がミュートされたことを SDK に伝えるには、次のように setAppMuted() メソッドを使用します。

Kotlin

MobileAds.setAppMuted(true)

Java

MobileAds.setAppMuted(true);

アプリ側の音量は、デフォルトでは 1（デバイスの現在の音量）に設定されており、アプリはミュートされていない状態です。

注: アプリのボリュームがミュート（値 0）であることがレポートされている場合は、広告リクエストを行っても、音声ミュートでの表示に適さない動画広告は返されません。これにより、一部の動画広告の提供が制限される可能性があります。

ネイティブ広告

ミュート設定を制御する手順については、VideoOptions をご覧ください。ネイティブ広告ではカスタム音量調節はサポートされていません。

Cookie の同意

アプリに特別な要件がある場合は、オプションの SharedPreferences gad_has_consent_for_cookies を設定できます。gad_has_consent_for_cookies がゼロに設定されている場合、SDK により制限付き広告（LTD）が有効にされます。

Kotlin

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
// Set the value to 0 to enable limited ads.
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()

Java

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
// Set the value to 0 to enable limited ads.
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();