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 行動廣告
適用於 Unity 的 Google 行動廣告外掛程式會以 .unitypackage
的形式發布在 GitHub 和 OpenUPM 存放區。
從 GitHub 匯入
- 從 GitHub 下載最新的
.unitypackage
版本。 - 選取 Unity 選單選項「Assets」>「Import package」>「Custom Package」,並匯入所有項目,即可匯入
.unitypackage
檔案。
使用 OpenUPM 匯入
使用 OpenUPM CLI 安裝 OpenUPM 登錄檔
如果您已經安裝 OpenUPM CLI,可以使用下列指令安裝 OpenUPM 登錄檔:
openupm add com.google.ads.mobile
手動安裝 OpenUPM 登錄檔
- 依序選取 Unity 選單選項「Edit」>「Project Settings」>「Package Manager」,開啟套件管理員設定。
在「Package Manager」視窗中,將 OpenUPM 新增為限定範圍的登錄檔:
Name: OpenUPM URL: https://package.openupm.com Scopes: com.google
安裝 Unity 專用 Google 行動廣告
- 依序選取 Unity 選單選項「Window」>「Package Manager」,開啟套件管理員選單。
設定管理員範圍下拉式選單,選取「My Registries」。
從套件清單中選取「Google Mobile Ads for Unity」套件,然後按下「Install」。
包含外部依附元件
Google 行動廣告 Unity 外掛程式會透過 Unity Play 服務解析器程式庫發布。這個程式庫適用於任何需要存取 Android 專用程式庫 (例如 AAR 或 iOS CocoaPods) 的 Unity 外掛程式。此 API 可讓 Unity 外掛程式宣告依附元件,隨後會自動解析並複製到您的 Unity 專案中。
請按照下列步驟操作,確保專案包含所有依附元件:
Android
依序前往「Project Settings」>「Player」>「Android」>「Publish Settings」>「Build」,然後選取:
- 自訂主要 Gradle 範本
- 自訂 Gradle 屬性範本
在 Unity 編輯器中,依序選取「Assets」>「External Dependency Manager」>「Android 解析器」>「Resolve」,讓 Unity External Dependency Manager 程式庫將宣告的依附元件複製到 Unity 應用程式的 Assets/Plugins/Android
目錄中。
iOS
您不需要採取其他步驟,將 Google Mobile Ads SDK 納入 Unity 專案。
系統會使用 CocoaPods 識別 iOS 依附元件。CocoaPods 可做為建構後程序步驟執行。
- 使用 Unity 5.6 或以上版本時,系統會產生包含必要依附元件程式庫的 xcworkspace。請使用產生的 xcworkspace,而非標準 Xcode 專案。
- 使用舊版 Unity 時,依附元件會包含在標準 Xcode 專案中。
Google 行動廣告 Unity 外掛程式依附元件列於 Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml
中。
設定應用程式 ID AdMob
在 Unity 編輯器中,從選單中依序選取「Assets」>「Google Mobile Ads」>「Settings」。
在每個欄位中輸入您的 Android 和 iOS AdMob 應用程式 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 提供多種廣告格式,您可以挑選最適合使用者體驗的廣告格式。
橫幅廣告
橫幅廣告單元會顯示佔用應用程式版面配置一部分的矩形廣告。且會在一段時間後自動重新整理。這表示即使使用者一直留在應用程式的同一個畫面,仍會定期看到新廣告。這也是最簡單的導入廣告格式。
插頁式
插頁式廣告單元會在應用程式中顯示全版廣告,將廣告放在應用程式介面上的自然中斷點和轉換點,例如在遊戲應用程式中過關後。
原生
原生廣告是可讓您自訂素材資源 (例如廣告標題和行動號召) 在應用程式中的顯示方式。自行設定廣告樣式,就能製作出自然、不會幹擾的廣告簡報,為使用者體驗增添更多元的體驗。
已獲得獎勵
獎勵廣告單元可讓使用者透過玩遊戲、參加問卷調查或觀看影片,獲得應用程式內獎勵,例如金幣、額外生命或積分。您可為不同的廣告單元設定不同的獎勵,並指定使用者獲得的獎勵價值和項目。
插頁式獎勵廣告
插頁式獎勵廣告是新型的獎勵廣告格式,可讓您針對在應用程式自然轉換期間自動顯示的廣告提供獎勵 (例如金幣或額外生命)。
與獎勵廣告不同的是,獎勵廣告不需要等使用者選擇觀看。
插頁式獎勵廣告會顯示選擇觀看提示,而不是在獎勵廣告中顯示選擇觀看提示,改為提供簡介畫面,讓使用者有機會選擇是否取消訂閱。
應用程式開啟頁面廣告
應用程式開啟頁面廣告是一種廣告格式,會在使用者開啟或切換回應用程式時顯示,廣告會重疊在載入畫面。