MobileAds
クラスは、Google Mobile Ads SDK のグローバル設定を提供します。
動画広告の音量調整
アプリに独自の音量コントロール(カスタムの音楽や効果音の音量など)が備わっている場合、Google Mobile Ads SDK にアプリの音量を開示すると、動画広告でアプリの音量設定が考慮されます。これにより、予想される音量で動画広告をユーザーに配信できるようになります。
デバイスの音量は、音量ボタンまたは OS レベルの音量スライダーで制御され、デバイスの音声出力の音量を決定します。ただし、アプリはオーディオ エクスペリエンスを調整するために、デバイスの音量に対する音量レベルを個別に調整できます。アプリ起動時、バナー、インタースティシャル、リワード、リワード インタースティシャル広告のフォーマットでは、静的 setAppVolume()
メソッドによりアプリの相対的なボリュームを SDK に報告できます。有効な広告ボリュームの値の範囲は、0.0
(無音)から 1.0
(現在のデバイスの音量)までです。次の例は、相対的なアプリ ボリュームを SDK に報告する方法を示しています。
Java
@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(); }
Kotlin
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()
メソッドを使用します。
Java
MobileAds.setAppMuted(true);
Kotlin
MobileAds.setAppMuted(true)
デフォルトでは、アプリの音量は 1
(現在のデバイスの音量)に設定され、アプリはミュートされていません。
ネイティブ広告
ミュート設定を制御する方法については、VideoOptions
をご覧ください。現在のところ、ネイティブ広告ではカスタムの音量調整はサポートされていません。
Cookie に関する同意
アプリに特別な要件がある場合は、オプションの SharedPreferences
gad_has_consent_for_cookies
を設定できます。gad_has_consent_for_cookies
設定がゼロに設定されている場合、SDK は
制限付き広告(LTD)
を有効にします。
Java
Context activity = getActivity(); SharedPreferences sharedPreferences = PreferenceManager.getDefaultSharedPreferences(activity); sharedPreferences.edit().putInt("gad_has_consent_for_cookies", 0).apply();
Kotlin
val sharedPrefs = PreferenceManager.getDefaultSharedPreferences(context) sharedPrefs.edit().putInt("gad_has_consent_for_cookies", 0).apply()