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.

Chế độ 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. Đ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ị (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 số 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:

Java

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    
    MobileAds.initialize(this);
    
    // 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)
    ...
}

Để 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():

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 và 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à tắt tiếng hoặc được đặt thành giá trị 0. Việc này có thể hạn chế một phần trong nhóm quảng cáo dạng video rộng hơn phân phát.

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. Tính năng kiểm soát âm lượng tuỳ chỉnh hiện không được hỗ trợ 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 bạn đặt lựa chọn ưu tiên về 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()