Cài đặt chung

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

Lớp MobileAds cung cấp các chế độ cài đặt chung cho Google Mobile Ads SDK.

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

Google Mobile Ads SDK nâng cao các 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 các 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 Google Mobile Ads SDK với luồng chính của Unity.

Đồng bộ hoá các sự kiện quảng cáo với luồng chính của Unity theo cách thủ công hoặc tự động bằng cách cho phép Google Mobile Ads SDK xử lý quá trình đồng bộ hoá.

Đề xuất: Đồng bộ hoá các sự kiện quảng cáo theo cách thủ công

Để đồng bộ hoá các sự kiện quảng cáo theo cách thủ công, hãy sử dụng phương thức ExecuteInUpdate trên luồng chính. Bạn phải sử dụng phương thức ExecuteInUpdate khi tương tác với các đối tượng UnityEngine và khi thuộc tính RaiseAdEventsOnUnityMainThread bị tắt.

Ví dụ sau đây ghi lại một luồng nền và chạy một hành động để tương tác với các đối tượng UnityEngine:

rewardedAd.OnAdPaid += (AdValue value) =>
{
    // Log the ad value immediately.
    // Place all time-sensitive code outside of ExecuteInUpdate().
    UnityEngine.Debug.Log($"Received ad value of {value.Value} {value.CurrencyCode}.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects here.
        // This method is delayed, don't put time sensitive code here.
    });
};

Quan trọng: Vòng lặp Update() của Unity sẽ trì hoãn tất cả mã được đặt bên trong phương thức ExecuteInUpdate. Bạn phải đặt tất cả mã nhạy cảm về thời gian, chẳng hạn như dữ liệu đo từ xa hoặc doanh thu từ quảng cáo ở cấp lượt hiển thị (ILAR) bên ngoài phương thức ExecuteInUpdate.

Tự động hoá quá trình đồng bộ hoá trên các sự kiện quảng cáo

Để Google Mobile Ads SDK đồng bộ hoá các sự kiện quảng cáo, hãy đặt MobileAds.RaiseAdEventsOnUnityMainThread thuộc tính thành true:

...
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;
    }
}

Cảnh báo: Khi đặt MobileAds.RaiseAdEventsOnUnityMainThread thành giá trị true, các sự kiện quảng cáo được kích hoạt khi trò chơi của bạn bị tạm dừng hoặc chạy trong nền sẽ bị trì hoãn cho đến khi người dùng quay lại trò chơi. Nếu người dùng đóng ứng dụng trong thời gian này, thì các sự kiện quảng cáo bị trì hoãn này sẽ bị loại bỏ hoàn toàn. Các nhà xuất bản đặt MobileAds.RaiseAdEventsOnUnityMainThread thành true đã báo cáo mức chênh lệch lên đến 30% trong báo cáo doanh thu từ quảng cáo ở cấp lượt hiển thị. Đề xuất:Thay vào đó, hãy đồng bộ hoá từng sự kiện quảng cáo riêng lẻ theo cách thủ cô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 lượng hiệu ứng âm thanh hoặc âm nhạc tuỳ chỉnh), thì việc cho Google Mobile Ads SDK 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 như mong đợi.

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

Bạn có thể báo cáo âm lượng tương ứng của ứng dụng cho Google Mobile Ads SDK bằng cách gọi phương thức SetApplicationVolume() trước khi tải quảng cáo. 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ị). Dưới đây là một ví dụ về cách báo cáo âm lượng ứng dụng tương ứng cho SDK:

// Set app volume to be half of current device volume.
MobileAds.SetApplicationVolume(0.5f);

Cảnh báo: Việc giảm âm lượng âm thanh của ứng dụng sẽ làm giảm điều kiện đủ điều kiện cho quảng cáo dạng video và có thể làm giảm doanh thu từ quảng cáo của ứng dụng. Bạn chỉ nên sử dụng phương thức này nếu ứng dụng của bạn cung cấp các chế độ kiểm soát âm lượng tuỳ chỉnh cho người dùng và âm lượng của người dùng được phản ánh đúng trong ứng dụng.

Để thông báo cho SDK biết rằng âm lượng ứng dụng đã bị tắt tiếng, hãy gọi phương thức SetApplicationMuted() trước khi tải quảng cáo:

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

Cảnh báo: Việc tắt tiếng ứng dụng sẽ làm giảm điều kiện đủ điều kiện cho quảng cáo dạng video và có thể làm giảm doanh thu từ quảng cáo của ứng dụng. Bạn chỉ nên sử dụng phương thức này nếu ứng dụng của bạn cung cấp chế độ kiểm soát tắt tiếng tuỳ chỉnh cho người dùng và quyết định tắt tiếng của người dùng được phản ánh đúng trong ứng dụng.

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

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

Thu gọn Android

Tuỳ chọn xuất bản Unity này cho phép bạn bật tính năng thu gọn mã java. Nếu bật tính năng thu gọn, bạn cũng cần tạo một tệp proguard tuỳ chỉnh để giữ các lớp được 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 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ố

Google Mobile Ads SDK 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();
}

Lấy phiên bản trình bổ trợ Unity

Để lấy phiên bản SDK Unity, hãy chạy lệnh sau:

// Get the unity SDK version.
Debug.Log("Unity SDK Version: " + MobileAds.GetVersion());

Lấy phiên bản nền tảng

Google Mobile Ads SDK cho Unity phụ thuộc vào SDK nền tảng Android và iOS. Để lấy phiên bản SDK nền tảng, hãy chạy lệnh sau:

// Get the underlying platform SDK version.
Debug.Log("Platform SDK Version: " + MobileAds.GetPlatformVersion());