設定 Google Mobile Ads Unity 外掛程式

選取平台： Android iOS Unity Flutter Android (舊版)

Unity 開發人員可使用 Google Mobile Ads Unity 外掛程式，在 Android 和 iOS 應用程式中放送 Google 行動廣告，不需編寫 Java 或 Objective-C 程式碼。外掛程式提供 C# 介面，可用於請求 Unity 專案中 C# 指令碼所使用的廣告。

本指南適用於想透過 Unity 應用程式營利的發布商。

必要條件

• 使用 Unity 編輯器 2019.4 以上版本。
  • 建議使用 2022.2 以上版本。
• 如要在 iOS 上部署
  • Xcode 16.0 以上版本
  • 指定 iOS 13.0 以上版本
  • CocoaPods
• 如要在 Android 上部署
  • 最低需求為 Android API 級別 24 以上版本
  • 指定 Android API 級別 35 以上版本

如要設定 Android API 級別，請依序前往「Project Settings」>「Player」>「Android」>「Other Settings」>「Other Settings」。

匯入 Unity 適用的行動廣告外掛程式

OpenUPM-CLI

如果已安裝 OpenUPM CLI，可以使用下列指令安裝 OpenUPM 套件：

openupm add com.google.ads.mobile

移除 .unitypackage 外掛程式素材資源

如要從 .unitypackage 改用 OpenUPM，請務必從原本位置手動解除安裝素材資源。移除從 .unitypackage 匯入的下列目錄：

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

透過 UI 使用 OpenUPM

1. 在 Unity 選單中，依序選取「Edit」>「Project Settings」>「Package Manager」，開啟套件管理工具設定。

2. 在「Package Manager」視窗中，將 OpenUPM 新增為指定範圍套件來源：

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. 在 Unity 選單中，依序選取「Window」>「Package Manager」，開啟套件管理工具選單。

4. 設定管理員範圍下拉式選單，選取「My Registries」。

   

5. 從套件清單中選取「Google Mobile Ads for Unity」套件，然後按一下「Install」。

移除 .unitypackage 外掛程式素材資源

如要從 .unitypackage 改用 OpenUPM，請務必從原本位置手動解除安裝素材資源。移除從 .unitypackage 匯入的下列目錄：

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

1. 擷取最新版的版本標記。傳回的標記 (不含 v 前置字元) 是 Google Mobile Ads Unity Plugin版本。

   • macOS 和 Linux

     curl -sS https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest | jq -r '.tag_name'

   • Windows PowerShell

     (Invoke-RestMethod -Uri "https://api.github.com/repos/googleads/googleads-mobile-unity/releases/latest").tag_name
     

2. 修改 Packages/manifest.json 檔案，使用從上述指令取得的版本，將 OpenUPM 新增為指定範圍套件來源和依附元件：

   {
     "scopedRegistries": [
       {
         "name": "google",
         "url": "https://package.openupm.com",
         "scopes": [
           "com.google"
         ]
       }
     ],
     "dependencies": {
       "com.google.ads.mobile": "11.6.0"
     }
   }
   

移除 .unitypackage 外掛程式素材資源

如要從 .unitypackage 改用 OpenUPM，請務必從原本位置手動解除安裝素材資源。移除從 .unitypackage 匯入的下列目錄：

• Assets/ExternalDependencyManager
• Assets/GoogleMobileAds
• Assets/Plugins/Android/googlemobileads-unity.aar
• Assets/Plugins/Android/GoogleMobileAdsPlugin
• Assets/Plugins/iOS/GADUAdNetworkExtras
• Assets/Plugins/iOS/unity-plugin-library.a

從 GitHub 匯入

1. 從 GitHub 下載 .unitypackage 版本。
2. 如要匯入 .unitypackage 檔案，請在 Unity 選單中依序選取「Assets」>「Import package」>「Custom Package」，然後匯入所有項目。

選用：停用 External Dependency Manager

如果您使用自己的建構工具管理 Android 和 iOS 程式庫，可以停用 com.unity.external-dependency-manager 套件：

在 Unity 編輯器中，依序選取「Window」>「Package Manager」，然後移除「External Dependency Manager」 (com.unity.external-dependency-manager) 套件。移除這個套件後，依序點選「Assets」>「Google Mobile Ads」>「Settings」，清除「Enable External Dependency Manager」。

注意： 刪除 GoogleMobileAdsSettings.asset 檔案會重設設定，並在下次匯入或載入編輯器時重新安裝 com.unity.external-dependency-manager 套件。如要日後重新安裝套件，請依序選取「Assets」>「Google Mobile Ads」>「Settings」，然後選取「Enable External Dependency Manager」。

安裝舊版 External Dependency Manager

如果專案使用 Unity 2022.2 以下版本，您可以在停用 Unity 的套件後，安裝 Google 的舊版 com.google.external-dependency-manager 套件：

• 從適用於 Unity 的 External Dependency Manager 版本頁面下載最新的 .unitypackage 檔案，然後依序選取「Assets」>「Import Package」>「Custom Package」。

• 執行下列 OpenUPM CLI 指令：

  openupm add com.google.external-dependency-manager

手動設定原生依附元件

如果您不使用 External Dependency Manager 套件，請將 Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml 和 Assets/GoogleMobileAds/Editor/GoogleUmpDependencies.xml 檔案中的必要程式庫新增至建構檔案：

• 如果是 Android，請依序選取「Edit」>「Project Settings」>「Player」>「Android」>「Publishing Settings」>「Build」，然後啟用「Custom Main Gradle Template」。將 GoogleMobileAdsDependencies.xml 和 GoogleUmpDependencies.xml 檔案中的必要程式庫，新增至 Assets/Plugins/Android/mainTemplate.gradle 檔案的 dependencies 區塊：

  implementation 'com.google.android.gms:play-services-ads:25.5.0'
  implementation 'com.google.android.ump:user-messaging-platform:4.0.0'
  

  此外，請使用 GoogleMobileAdsDependencies.xml 檔案中的版本，新增 androidx.constraintlayout:constraintlayout、androidx.lifecycle:lifecycle-process 和 androidx.fragment:fragment 套件。

• 如果是 iOS，請匯出 Xcode 專案。將 GoogleMobileAdsDependencies.xml 和 GoogleUmpDependencies.xml 檔案中必要的 Pod 新增至匯出專案資料夾中的 Podfile 檔案：

  pod 'Google-Mobile-Ads-SDK', '~> 13.11.0'
  pod 'GoogleUserMessagingPlatform', '3.1.0'
  

  接著，在匯出的 iOS 專案資料夾中執行下列指令：

  pod install --repo-update

設定 Ad Manager 應用程式 ID

在 Unity 編輯器中，依序選取選單中的「Assets」>「Google Mobile Ads」>「Settings」。

在欄位中分別輸入 Android 和 iOS 的 Ad Manager 應用程式 ID。

Google Mobile Ads Unity Plugin會將這些設定儲存為 Assets/GoogleMobileAds/Resources/GoogleMobileAdsSettings.asset 設定檔中的文字。

初始化 SDK

應用程式必須先呼叫 MobileAds.Initialize()，初始化 Google Mobile Ads Unity Plugin 之後，才能載入廣告。這項操作只需執行一次，最佳時機是應用程式啟動時。

警告：呼叫 MobileAds.Initialize() 時，Google Mobile Ads Unity Plugin 或中介服務合作夥伴 SDK 可能會預先載入廣告。如須向歐洲經濟區、英國或瑞士的使用者取得同意聲明，請設定適用的要求專屬標記，例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent，或在載入廣告前採取相關行動。請務必先完成這項作業，再初始化 Google Mobile Ads Unity Plugin。

以下範例說明如何呼叫 MobileAds.Initialize()：

MobileAds.Initialize((InitializationStatus initstatus) =>
{
    if (initstatus == null)
    {
        Debug.LogError("Google Mobile Ads initialization failed.");
        return;
    }

    Debug.Log("Google Mobile Ads initialization complete.");

    MobileAdsEventExecutor.ExecuteInUpdate(() =>
    {
        // Interact with UnityEngine objects on the main thread here.
    });
});
GoogleMobileAdsController.cs

在主執行緒上與 Unity 物件互動

Google Mobile Ads Unity Plugin 會在背景執行緒中觸發廣告事件。如果廣告回呼與 Unity 物件 (例如 UnityEngine) 互動，請使用 MobileAdsEventExecutor.ExecuteInUpdate 方法，明確安排在 Unity 主執行緒上執行該工作。如需導入詳細資料，請參閱「在 Unity 主執行緒上觸發廣告事件」。

選取廣告格式

現在當您將 Unity 應用程式部署到 Android 或 iOS 平台時，應用程式會包含 Google Mobile Ads Unity Plugin，因此可直接開始導入廣告。AdMob 提供多種廣告格式，您可以選擇能提供最佳使用者體驗的格式。

橫幅廣告

橫幅廣告單元會占用應用程式的部分版面來顯示矩形廣告，且會固定在一段時間後自動重新整理。也就是說，即便使用者停留在應用程式的同一個畫面，每隔一段時間還是會看見新的廣告。這也是最容易導入的廣告格式。

導入橫幅廣告

插頁式廣告

您可以將插頁式廣告單元安插至使用者操作應用程式的空檔或轉換點 (例如通過遊戲應用程式關卡後)，在應用程式介面上顯示全版廣告。

導入插頁式廣告

原生

您可利用原生廣告，自訂應用程式顯示廣告標題、行動號召等素材資源的方式。藉由自行設定廣告樣式，您就能以自然、不突兀的方式呈現廣告，打造豐富的使用者體驗。

導入原生廣告

獎勵廣告

啟用獎勵廣告單元，使用者就能透過玩遊戲、參加問卷調查或觀看影片等方式，贏得應用程式內獎勵，例如金幣、額外生命值或積分。您可以為不同的廣告單元設定不同的獎勵，並指定使用者獲得的獎勵價值和道具。

導入獎勵廣告