Cài đặt chung

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

Kiểm soát â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 lượng tuỳ chỉnh âm nhạc hoặc hiệu ứng âm thanh), thì việc cho SDK quảng cáo trên thiết bị di động của Google biết âm lượng của ứng dụng sẽ cho phép quảng cáo dạng video tuân thủ chế độ cài đặt âm lượng của ứng dụng. Điều này đảm bảo người dùng nhận được quảng cáo dạng video có âm lượng âm thanh dự kiến.

Âm lượng của thiết bị, được điều khiển qua các nút âm lượng hoặc thanh trượt âm lượng cấp hệ điều hành, giúp 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 độ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 (tắt tiếng) đến 1.0 (âm lượng hiện tại của thiết bị). Dưới đây là ví dụ về cách báo cáo âm lượng tương ứng của ứng dụng cho 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)
  }
}

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

Java

MobileAds.setAppMuted(true);

Kotlin

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.

Lưu ý: Hệ thống sẽ không trả về những quảng cáo dạng video không đủ điều kiện xuất hiện ở chế độ bị tắt tiếng cho các yêu cầu quảng cáo được đưa ra khi âm lượng ứng dụng được báo cáo là bị tắt tiếng hoặc được đặt thành giá trị 0. Việc này có thể hạn chế việc phân phát một phần nhỏ trong nhóm quảng cáo dạng video rộng hơn.

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. Quảng cáo gốc hiện không hỗ trợ chức năng điều chỉnh âm lượng tuỳ chỉnh.

Sự đồng ý cho cookie

Nếu ứng dụng của bạn có các yêu cầu đặc biệt, 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 bạn đặt lựa chọn ưu tiên gad_has_consent_for_cookies thành 0.

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