Unity 開發人員可透過 Google 行動廣告 Unity 外掛程式，在 Android 和 iOS 應用程式中放送 Google 行動廣告，不必編寫 Java 或 Objective-C 程式碼。外掛程式提供 C# 介面，用於要求 Unity 專案中的 C# 指令碼廣告。
本指南適用於想透過 Unity 應用程式營利的發布商。
必要條件
- 使用 Unity 編輯器 2019.4 以上版本
- 如要部署至 iOS，請按照下列步驟操作：
- Xcode 16.0 以上版本
- 目標 iOS 12.0 以上版本
- CocoaPods
- 如要部署至 Android，請按照下列步驟操作：
- Android API 級別至少為 23 以上
- 以 Android API 級別 34 以上版本為目標
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
- 選取 Unity 選單選項「Edit」>「Project Settings」>「Package Manager」，開啟套件管理工具設定。
在「Package Manager」視窗中，將 OpenUPM 新增為範圍登錄檔：
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google選取 Unity 選單選項「Window」>「Package Manager」，開啟套件管理工具選單。
將管理員範圍下拉式選單設為選取「我的登錄」。
從套件清單中選取「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
從 GitHub 匯入
- 從 GitHub 下載最新
.unitypackage版本。 - 依序選取 Unity 選單選項「Assets」>「Import package」>「Custom Package」，然後匯入所有項目，即可匯入
.unitypackage檔案。
包含外部依附元件
Google 行動廣告 Unity 外掛程式會隨 Unity Play 服務解析器程式庫發布。任何需要存取 Android 專用程式庫 (例如 AAR) 或 iOS CocoaPods 的 Unity 外掛程式，都可使用這個程式庫。這個外掛程式可讓 Unity 外掛程式宣告依附元件，然後自動解析並複製到 Unity 專案中。
請按照下列步驟，確保專案包含所有依附元件：
Android
依序前往「Project Settings」>「Player」>「Android」>「Publishing Settings」>「Build」，然後選取：
- 自訂主要 Gradle 範本
- 自訂 Gradle 屬性範本
在 Unity 編輯器中，依序選取「Assets」>「External Dependency Manager」>「Android Resolver」>「Resolve」，讓 Unity External Dependency Manager 程式庫將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android 目錄。
iOS
iOS 版 Unity 會使用 CocoaPods 識別及管理依附元件。如需與 iOS 依附元件相關的特定需求或疑難排解步驟，請參閱 CocoaPods 說明文件。
Google 行動廣告 Unity 外掛程式的依附元件會列在 Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml 中。
設定 AdMob 應用程式 ID
在 Unity 編輯器中，依序選取選單中的「Assets」>「Google Mobile Ads」>「Settings」。
在各個欄位中輸入 Android 和 iOS 的 AdMob 應用程式 ID。
初始化 SDK
應用程式載入廣告前，請先呼叫 MobileAds.Initialize()，初始化 Google Mobile Ads SDK。這項操作只需執行一次，最好是在應用程式啟動時進行。
以下範例說明如何呼叫 MobileAds.Initialize()：
MobileAds.Initialize((InitializationStatus initstatus) =>
{
if (initstatus == null)
{
Debug.LogError("Google Mobile Ads initialization failed.");
return;
}
Debug.Log("Google Mobile Ads initialization complete.");
// Google Mobile Ads events are raised off the Unity Main thread. If you need to
// access UnityEngine objects after initialization,
// use MobileAdsEventExecutor.ExecuteInUpdate(). For more information, see:
// https://developers.google.com/admob/unity/global-settings#raise_ad_events_on_the_unity_main_thread
});
如果您使用中介服務，請等到回呼發生後再載入廣告，確保所有中介服務轉接程式都已初始化。
選取廣告格式
部署至 Android 或 iOS 平台時，Google Mobile Ads SDK 現在會納入 Unity 應用程式中。現在可以開始導入廣告。AdMob 提供多種不同的廣告格式，您可以選擇最能提供最佳使用者體驗的格式。
橫幅廣告
橫幅廣告單元會占用應用程式的部分版面來顯示矩形廣告。且會固定在一段時間後自動重新整理。也就是說，即使使用者一直停留在應用程式的同一個畫面，每隔一段時間還是能看見新的廣告。這也是導入方式最簡單的廣告格式。
插頁式
您可以將插頁式廣告單元安插至使用者操作應用程式的空檔或轉換點 (例如通過遊戲應用程式關卡後)，在應用程式介面上顯示全版廣告。
原生
原生廣告可讓您自訂應用程式中顯示廣告標題和行動號召等素材資源的方式。自行設定廣告樣式，打造自然不突兀的廣告呈現方式，提升豐富的使用者體驗。
已獲得獎勵
獎勵廣告單元可讓使用者透過玩遊戲、參加問卷調查或觀看影片等方式，贏得應用程式內獎勵，例如金幣、額外生命數或積分。您可以為不同的廣告單元設定不同的獎勵，並指定使用者可獲得的獎勵價值和道具。
插頁式獎勵廣告
插頁式獎勵廣告是一種全新的獎勵廣告格式，您可在應用程式自然轉換時自動顯示這類廣告，向使用者提供獎勵，例如錢幣或額外生命。
與獎勵廣告不同的是，插頁式獎勵廣告不需要等使用者確定選擇觀看即可放送。
獎勵廣告會顯示選擇觀看的提示，插頁式獎勵廣告則是顯示獎勵簡介畫面，使用者可選擇不觀看廣告。
應用程式開啟頁面廣告
應用程式開啟頁面廣告是一種廣告格式，會在使用者開啟或切換回您的應用程式時顯示。廣告會疊在載入畫面上。