開始使用

Google 行動廣告 Unity 外掛程式可讓 Unity 開發人員在 Android 和 iOS 應用程式上放送 Google 行動廣告，完全不必編寫 Java 或 Objective-C 程式碼。這個外掛程式提供 C# 介面，用於要求 Unity 專案中的 C# 指令碼使用的廣告。

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

先備知識

  • 使用 Unity 2019.4 以上版本
  • 部署至 iOS
    • Xcode 15.3 以上版本
    • 指定 iOS 12.0 以上版本
    • CocoaPods
  • 部署至 Android
    • 最低 Android API 級別為 21 以上
    • 指定 Android API 級別 31 以上版本

如要查看 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 匯入的目錄：

  • 資產/ExternalDependencyManager
  • 素材資源/GoogleMobileAds
  • Assets/Plugins/Android/googlemobileads-unity.aar
  • Assets/Plugins/Android/GoogleMobileAdsPlugin
  • Assets/Plugins/iOS/GADUAdNetworkExtras
  • Assets/Plugins/iOS/unity-plugin-library.a

OpenUPM

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

  2. 將 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 匯入的目錄：

  • 資產/ExternalDependencyManager
  • 素材資源/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. 依序選取 Unity 選單選項「Assets」>「Import package」>「Custom Package」，然後匯入所有項目，即可匯入 .unitypackage 檔案。

納入外部依附元件

Google 行動廣告 Unity 外掛程式是以 Unity Play 服務解析器程式庫發布。這個程式庫是供任何需要存取 Android 專用程式庫 (例如 AAR 或 iOS CocoaPods) 的 Unity 外掛程式使用。可讓 Unity 外掛程式宣告依附元件，接著系統會自動將這些元件解析並複製到您的 Unity 專案中。

請按照下列步驟操作，確保專案包含所有依附元件：

Android

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

  • 自訂主要 Gradle 範本
  • 自訂 Gradle 屬性範本

在 Unity 編輯器中，依序選取「Assets」>「External Dependency Manager」>「Android Resolver」>「Resolve」，即可讓 Unity External Dependency Manager 程式庫將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄中。

iOS

您不需要採取任何額外步驟，即可將 Google Mobile Ads SDK 納入 Unity 專案。

iOS 依附元件是使用 CocoaPods 來辨識。CocoaPods 可做為建構後程序步驟執行。

  • 使用 Unity 5.6 以上版本時，系統會產生 xcworkspace，其中包含必要的依附元件程式庫。使用產生的 xcworkspace 而非標準 Xcode 專案。
  • 使用舊版 Unity 時，系統會將依附元件包含在標準 Xcode 專案中。

Google 行動廣告 Unity 外掛程式依附元件會列在 Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml 中。

設定 Ad Manager 應用程式 ID

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

輸入您的 Android 和 iOS Ad Manager 應用程式 ID 。

初始化 SDK

載入廣告前，請先呼叫 MobileAds.Initialize()，讓應用程式初始化 Google Mobile Ads SDK。這項操作只需執行一次 (最好在應用程式啟動時)。

以下範例說明如何在附加至 GameObject 的指令碼的 Start() 方法中呼叫 Initialize()：

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

如果您使用中介服務，請等到回呼發生後再載入廣告，以確保所有中介服務轉接程式都已初始化。

選取廣告格式

現在，只要部署至 Android 或 iOS 平台，Unity 應用程式就會納入 Google Mobile Ads SDK。您現在可以開始導入廣告了。AdMob 提供多種廣告格式，您可以選用能帶來最佳使用者體驗的廣告格式。

橫幅廣告單元會佔用應用程式的部分版面配置，而且會經過一段時間後自動重新整理。換句話說，使用者每隔一段時間就會看到新廣告，即使他們停留在應用程式中的同一個畫面也一樣。這也是最簡單的廣告格式。

導入橫幅廣告

插頁式

插頁式廣告單元會在您應用程式中顯示全頁廣告。您可以將這類廣告放置在應用程式介面的自然中斷處和轉換點，例如遊戲應用程式過關後。

導入插頁式廣告

原生

原生廣告可讓您自訂素材資源 (例如廣告標題和行動號召) 在應用程式中的呈現方式。藉由自行設定廣告樣式，您就能建立不會幹擾使用者的自然廣告展示，增添獨特的使用者體驗。

導入原生廣告

已獲得獎勵

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

導入獎勵廣告