通用設定

MobileAds 類別提供 Google Mobile Ads SDK 的通用設定。

在 Unity 主執行緒上引發廣告事件

Google Mobile Ads SDK 在與 Unity 主執行緒不同的執行緒上引發事件。如果您導入廣告事件並與 Unity 物件互動，就必須將 Mobile Ads SDK 事件與 Unity 主執行緒同步處理。

如果您想讓 Mobile Ads SDK 為您處理這個執行緒問題，請將 MobileAds.RaiseAdEventsOnUnityMainThread 設為 true。這會強制 SDK 在 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;
    }
}

注意： 在 Unity 主執行緒上引發事件的副作用，是指當使用者返回應用程式，像是 OnAdFullScreenContentOpened 這類特定事件才會引發。

影片廣告音量控制項

如果應用程式有自己的音量控制選項 (例如自訂音樂或音效音量)，向 Google Mobile Ads SDK 揭露應用程式音量即可讓影片廣告遵循應用程式音量設定。這樣可確保使用者接收到預期音訊音量的影片廣告。

裝置音量 (透過音量按鈕或作業系統層級音量滑桿控制) 會決定裝置音訊輸出的音量。不過，應用程式可以根據裝置音量獨立調整音量，打造專屬的音訊體驗。

您可以呼叫 SetApplicationVolume() 方法，向 Google Mobile Ads SDK 回報相對應用程式音量。有效廣告音量值介於 0.0 (靜音) 到 1.0 (目前裝置音量) 之間。以下範例說明如何向 SDK 回報相對的應用程式數量：

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

警告： 降低應用程式的音訊音量後，影片廣告就不符合放送資格，且可能導致應用程式的廣告收益下滑。建議您只在應用程式已為使用者提供自訂音量控制項，且應用程式能正確反映使用者音量時，再使用這個方法。

如要告知 SDK 應用程式音量已設為靜音，請使用 SetApplicationMuted() 方法：

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

根據預設，應用程式音量設為 1、目前裝置音量，應用程式未設為靜音。

警告： 忽略應用程式會減少影片廣告放送資格，且可能會降低應用程式的廣告收益。建議您只在應用程式為使用者提供自訂靜音控制項，且使用者能在應用程式中正確反映使用者的靜音決定時，才使用這個方法。

Cookie 同意聲明

如果您的應用程式有特殊規定，您可以將選用的 ApplicationPreferences 金鑰 gad_has_consent_for_cookies 設為零，啟用受限制的廣告 (LTD)：

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

Android 壓縮

這個 Unity 發布選項可讓您啟用 Java 程式碼壓縮。如果啟用壓縮功能，您也需要建立自訂 ProGuard 檔案，以保留 SDK 參照的類別。

1. 啟用自訂 Proguard 檔案

   依序前往「Project Settings」>「Player」>「Android」>「Publish Settings」>「Build」，然後選取：

   • 自訂 Proguard 檔案

2. 開啟 /Assets/Plugins/Android/proguard-user.txt 並新增下列項目：

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