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.

Tăng sự kiện quảng cáo trên luồng chính của Unity

SDK Quảng cáo của Google trên thiết bị di động tăng các sự kiện trên một chuỗi khác với chuỗi chính của Unity. Nếu triển khai các sự kiện quảng cáo và tương tác với đối tượng Unity, thì bạn phải đồng bộ hoá các sự kiện SDK quảng cáo trên thiết bị di động với luồng chính của Unity.

Nếu bạn muốn SDK quảng cáo trên thiết bị di động xử lý vấn đề về chuỗi này cho bạn, hãy đặt MobileAds.RaiseAdEventsOnUnityMainThread thành true. Điều này buộc SDK phải đưa ra tất cả các sự kiện và lệnh gọi lại trên luồng chính của Unity.

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be raised
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;
    }
}

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 ứ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.

Bạn có thể báo cáo âm lượng ứng dụng tương ứng cho SDK quảng cáo trên thiết bị di động của Google bằng cách gọi phương thức SetApplicationVolume(). 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:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(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 SetApplicationMuted():

// Set app to be muted.
MobileAds.SetApplicationMuted(true);

Theo mặc định, âm lượng ứ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.

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 khoá ApplicationPreferences (không bắt buộc) gad_has_consent_for_cookies thành 0 để bật quảng cáo bị hạn chế (LTD):

// Enable limited ads (LTD)
ApplicationPreferences.SetInt("gad_has_consent_for_cookies", 0);

Giảm kích thước Android

Tuỳ chọn phát hành Unity này cho phép bạn bật tính năng rút gọn mã java. Nếu bật tính năng giảm thiểu, bạn cũng cần tạo một tệp Proguard tuỳ chỉnh để giữ lại các lớp mà SDK tham chiếu.

  1. Bật tệp Proguard tuỳ chỉnh

    Chuyển đến Project Settings > Player > Android > Publishing Settings > Build (Cài đặt dự án > Trình phát > Android > Cài đặt xuất bản > Bản dựng) rồi chọn:

    • Tệp Proguard tuỳ chỉnh

  2. Mở /Assets/Plugins/Android/proguard-user.txt và thêm vào như sau:

-keep class com.google.** { public *; }