全般設定

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

動画広告の音量調整

アプリに独自の音量コントロール（カスタムの音楽や効果音の音量など）が備わっている場合、Google Mobile Ads SDK にアプリの音量を開示すると、動画広告でアプリの音量設定が考慮されます。これにより、予想される音量で動画広告をユーザーに配信できるようになります。

デバイスの音量は、音量ボタンまたは OS レベルの音量スライダーで制御され、デバイスの音声出力の音量を決定します。ただし、アプリはオーディオ エクスペリエンスを調整するために、デバイスの音量に対する音量レベルを個別に調整できます。アプリ起動時、バナー、インタースティシャル、リワード、リワード インタースティシャル広告のフォーマットでは、静的 setAppVolume() メソッドによりアプリの相対的なボリュームを SDK に報告できます。有効な広告ボリュームの値の範囲は、0.0（無音）から 1.0（現在のデバイスの音量）までです。次の例は、相対的なアプリ ボリュームを SDK に報告する方法を示しています。

@Override
protected void onCreate(Bundle savedInstanceState) {
  super.onCreate(savedInstanceState);
  setContentView(R.layout.activity_my);

  new Thread(
          () -> {
            // Initialize the 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();
}

override fun onCreate(savedInstanceState: Bundle?) {
  super.onCreate(savedInstanceState)
  setContentView(R.layout.activity_main)

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize the 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)
  }
}

アプリ ボリュームがミュートされたことを SDK に通知するには、setAppMuted() メソッドを使用します。

MobileAds.setAppMuted(true);

MobileAds.setAppMuted(true)

デフォルトでは、アプリの音量は 1（現在のデバイスの音量）に設定され、アプリはミュートされていません。

ネイティブ広告

ミュート設定を制御する方法については、VideoOptions をご覧ください。現在のところ、ネイティブ広告ではカスタムの音量調整はサポートされていません。

Cookie に関する同意

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

Context activity = getActivity();
SharedPreferences sharedPreferences =
  PreferenceManager.getDefaultSharedPreferences(activity);
sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();

val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context)
sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()