全般設定

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);
    
    MobileAds.initialize(this, new OnInitializationCompleteListener() {
        @Override
        public void onInitializationComplete(InitializationStatus initializationStatus) {}
    });
    
    // Set app volume to be half of current device volume.
    MobileAds.setAppVolume(0.5f);
    ...
}

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    MobileAds.initialize(this) {}
    
    // 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()