Cài đặt chung

Chọn nền tảng: Android iOS Unity

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.

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ứ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ị (mà bạn có thể kiểm soát 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ể tự điều chỉnh mức âm lượng tương ứng với mức â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:

Kotlin

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

  val backgroundScope = CoroutineScope(Dispatchers.IO)
  backgroundScope.launch {
    // Initialize 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)
  }
}

Java

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

  new Thread(
          () -> {
            // Initialize 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():

Kotlin

MobileAds.setAppMuted(true)

Java

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 không trả về những quảng cáo dạng video không đủ điều kiện xuất hiện ở trạng thái 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à đang ở trạng thái tắt tiếng hoặc có giá trị bằng 0. Việc này có thể hạn chế hoạt động phân phát một phần nhỏ của nhóm quảng cáo dạng video lớn hơn.

Quảng cáo gốc

Xem phần 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 không hỗ trợ chế độ điều chỉnh âm lượng tuỳ chỉnh.

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.

Kotlin

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

Java

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