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
- 依序選取 Unity 選單選項「Edit」>「Project Settings」>「Package Manager」,開啟套件管理員設定。
將 OpenUPM 新增為「套件管理員」視窗的限定範圍登錄檔:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
依序選取 Unity 選單選項「Window」>「Package Manager」,開啟套件管理員選單。
設定管理員範圍下拉式選單,選取「My Registries」(我的註冊資料庫)。
從套件清單中選取「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 匯入
- 從 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」>「Publish 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
中。
設定 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 提供多種廣告格式,您可以選用能帶來最佳使用者體驗的廣告格式。
橫幅廣告
橫幅廣告單元會佔用應用程式的部分版面配置,而且會經過一段時間後自動重新整理。換句話說,使用者每隔一段時間就會看到新廣告,即使他們停留在應用程式中的同一個畫面也一樣。這也是最簡單的廣告格式。
插頁式
插頁式廣告單元會在您應用程式中顯示全頁廣告。您可以將這類廣告放置在應用程式介面的自然中斷處和轉換點,例如遊戲應用程式過關後。
原生
原生廣告可讓您自訂素材資源 (例如廣告標題和行動號召) 在應用程式中的呈現方式。藉由自行設定廣告樣式,您就能建立不會幹擾使用者的自然廣告展示,增添獨特的使用者體驗。
已獲得獎勵
獎勵廣告單元可讓使用者透過玩遊戲、參加問卷調查或觀看影片,贏得應用程式內獎勵,例如金幣、額外生命或積分。您可為不同的廣告單元設定不同的獎勵,並指定使用者獲得的獎勵價值和項目。