Cài đặt chung

Lớp MobileAds cung cấp các chế độ cài đặt chung cho SDK quảng cáo của Google trên thiết bị di động.

Điều khiển âm lượng của quảng cáo dạng video

Nếu ứng dụng của bạn có các chế độ kiểm soát âm lượng riêng (chẳng hạn như mức âm lượng của hiệu ứng âm thanh hoặc âm nhạc tuỳ chỉnh), thì việc cho SDK quảng cáo trên thiết bị di động của Google biết mức âm lượng của ứng dụng sẽ cho phép quảng cáo dạng video tuân thủ các chế độ cài đặt âm lượng của ứng dụng. Việc này đảm bảo người dùng nhận được quảng cáo dạng video có âm lượng mong muốn.

Âm lượng của thiết bị (được điều khiển thông qua các nút âm lượng hoặc thanh trượt âm lượng cấp hệ điều hành) sẽ xác định âm lượng cho đầu ra âm thanh của thiết bị. Tuy nhiên, các ứng dụng có thể điều chỉnh một cách độc lập mức âm lượng tương ứng với âm lượng của thiết bị để điều chỉnh trải nghiệm âm thanh. Đối với các định dạng quảng cáo khi mở ứng dụng, quảng cáo biểu ngữ, quảng cáo xen kẽ, quảng cáo có tặng thưởng và quảng cáo xen kẽ có tặng thưởng, bạn có thể báo cáo âm lượng tương ứng của ứng dụng cho SDK thông qua phương thức setAppVolume() tĩnh. Các giá trị âm lượng hợp lệ của quảng cáo nằm trong khoảng từ 0.0 (im lặng) đến 1.0 (âm lượng hiện tại của thiết bị). Sau đây là một ví dụ về cách báo cáo âm lượng tương ứng của ứng dụng cho SDK:

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

  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)
  }
}

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

  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();
}

Để thông báo cho SDK biết rằng bạn đã tắt tiếng ứng dụng, hãy sử dụng phương thức setAppMuted():

MobileAds.setAppMuted(true)

MobileAds.setAppMuted(true);

Theo mặc định, âm lượng của ứng dụng được đặt thành 1 (âm lượng hiện tại của thiết bị) và ứng dụng không bị tắt tiếng.

Quảng cáo gốc

Hãy xem VideoOptions để biết hướng dẫn về cách kiểm soát chế độ cài đặt tắt tiếng. Không hỗ trợ tính năng điều khiển âm lượng tuỳ chỉnh cho quảng cáo gốc.

Sự đồng ý sử dụng cookie

Nếu ứng dụng của bạn có các yêu cầu đặc biệt, thì bạn có thể đặt SharedPreferences gad_has_consent_for_cookies (không bắt buộc). SDK sẽ bật quảng cáo bị hạn chế (LTD) khi lựa chọn ưu tiên về gad_has_consent_for_cookies được đặt thành 0.

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

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();