開始使用

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 級別 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 匯入的以下目錄：

• 素材資源/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. 選取 Unity 選單選項「Edit」>「Project Settings」>「Package Manager」，開啟套件管理工具設定。

2. 將 OpenUPM 新增為 Package Manager 視窗中的有範圍限制的登錄檔：

   Name: OpenUPM
   URL: https://package.openupm.com
   Scopes: com.google
   

3. 選取 Unity 選單選項「Window」>「Package Manager」，即可開啟「package manager」選單。

4. 將管理員範圍下拉式選單設為「我的註冊中心」。

   

5. 從套件清單中選取「Google Mobile Ads for Unity」套件，然後按下「Install」。

移除 .unitypackage 外掛程式素材資源

如果您要從使用 .unitypackage 遷移至使用 OpenUPM，則必須手動從舊位置解除安裝資產。移除從 .unitypackage 匯入的以下目錄：

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

納入外部依附元件

Google 行動廣告 Unity 外掛程式會隨 Unity Play 服務解析器程式庫一起發布。這個程式庫適用於任何需要存取 Android 專屬程式庫 (例如 AAR 或 iOS CocoaPods) 的 Unity 外掛程式。它可讓 Unity 外掛程式宣告依附元件，然後自動解析並複製至 Unity 專案。

重要事項：請使用最新版 Google Mobile Ads SDK，以便存取所有隱私權合規功能。

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

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

Unity for iOS 會使用 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。這項操作只需執行一次，最好是在應用程式啟動時執行。

警告： Google Mobile Ads SDK 或中介服務夥伴 SDK 可在呼叫 MobileAds.Initialize() 時預先載入廣告。如果您需要向歐洲經濟區 (EEA) 的使用者取得同意聲明，請設定任何要求專屬的標記 (例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent)，或在載入廣告前採取其他行動。請務必先完成這項操作，再初始化 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 平台時，Google Mobile Ads SDK 現已納入 Unity 應用程式。您現在可以導入廣告了。AdMob 提供多種不同的廣告格式，讓您選擇最能提供最佳使用者體驗的廣告格式。

橫幅廣告

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

導入橫幅廣告

插頁式

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

導入插頁式廣告

原生

原生廣告可讓您自訂應用程式中廣告標題和行動號召等素材資源的呈現方式。您可以自行設定廣告樣式，打造自然且不顯眼的廣告呈現方式，為使用者帶來更豐富的體驗。

導入原生廣告

已獲得獎勵

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

導入獎勵廣告