設定 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 級別 23 以上版本
    • 指定 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

OpenUPM (含 UI)

  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.4.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」，然後匯入所有項目。

設定 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()：

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

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

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

選取廣告格式

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

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

導入橫幅廣告

插頁式廣告

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

導入插頁式廣告

原生

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

導入原生廣告

獎勵廣告

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

導入獎勵廣告