全局设置

MobileAds 类为 Google 移动广告 SDK 提供全局设置。

视频广告音量控制

如果您的应用有自己的音量控制，例如自定义的音乐或音效音量，那么向 Google 移动广告 SDK 报告应用的音量后，视频广告会遵循相关的应用音量设置。这样可确保用户收到符合预期的视频广告音量。

设备音量（通过音量按钮或操作系统级音量滑块控制）决定了设备音频输出的音量。不过，应用可以相对于设备音量单独调整音量，以定制音频体验。您可以通过静态 setAppVolume() 方法向移动广告 SDK 报告相对的应用音量。广告音量的有效值范围为 0.0（静音）至 1.0（当前设备音量）。以下示例展示了如何向 SDK 报告相对的应用音量：

Java

@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);
    ...
}

Kotlin

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() 方法：

Java

MobileAds.setAppMuted(true);

Kotlin

MobileAds.setAppMuted(true)

默认情况下，应用音量设置为 1（当前设备音量），并且应用不会静音。

注意：当应用的音量报告为静音或设置为 0 值时，系统不会为广告请求返回不符合进行静音展示的视频广告。这可能会限制一部分视频广告的投放。

就使用 Cookie 征得用户同意

如果您的应用有特殊要求，您可以设置可选的 SharedPreferences gad_has_consent_for_cookies。当 gad_has_consent_for_cookies 偏好设置设为 0 时，移动广告 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()

同应用标识键

Google 移动广告 SDK 版本 21.4.0 引入了同应用标识键 ，帮助您通过使用从应用中收集的数据，投放更具相关性的个性化广告。同应用标识键默认处于启用状态，但您可以通过以下 API 将其停用。

Java

// Disables the same app key.
MobileAds.getInstance().enableSameAppKey(false);

Kotlin

// Disables the same app key.
MobileAds.getInstance().enableSameAppKey(false)