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.

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

SDK quảng cáo trên thiết bị di động của Google sẽ tạo sự kiện trên một luồng khác với luồng chính của Unity. Nếu triển khai sự kiện quảng cáo và tương tác với các đối tượng Unity, 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 Unity.

Nếu bạn muốn SDK quảng cáo trên thiết bị di động xử lý vấn đề về luồng 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ả 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;
    }
}

Đ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ị (mà bạn có thể đ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ể 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.

Bạn có thể báo cáo âm lượng tương ứng của ứng dụ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 (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:

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

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

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

Rút gọn 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 rút gọn, bạn cũng cần tạo một tệp proguard tuỳ chỉnh để giữ lại các lớp được SDK tham chiếu.

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

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

    • Tệp Proguard tuỳ chỉnh

  2. Mở /Assets/Plugins/Android/proguard-user.txt rồi thêm nội dung sau:

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

Tắt tính năng báo cáo sự cố

SDK quảng cáo trên thiết bị di động của Google thu thập báo cáo sự cố cho mục đích gỡ lỗi và phân tích. Bạn có thể tắt tính năng báo cáo sự cố này bằng mã sau. Các phần sau đây mô tả cách tắt tính năng báo cáo sự cố trên Android và iOS.

Android

Thêm thẻ <meta-data> với DISABLE_CRASH_REPORTING được đặt thành true trong tệp AndroidManifest.xml của ứng dụng:

<manifest>
   <application>
       <meta-data
           android:name="com.google.android.gms.ads.flag.DISABLE_CRASH_REPORTING"
           android:value="true" />
   </application>
</manifest>

iOS

Gọi phương thức DisableSDKCrashReporting để tắt báo cáo sự cố trên iOS:

void Awake() {
  MobileAds.DisableSDKCrashReporting();
}