開始使用

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

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

必要條件

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

• 建議採用：建立 AdMob 帳戶並註冊 Android 或 iOS 應用程式

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
• 素材資源/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] 選單選項 編輯 >專案設定 >套件管理員。

2. 將 OpenUPM 新增為 Package Manager 視窗中的受限登錄：

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

3. 選取 Unity 以開啟套件管理員選單 選單選項 [視窗] >套件管理員。

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

   

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

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

如果要從使用 .unitypackage 遷移至使用 OpenUPM， 必須從舊位置手動解除安裝素材資源。移除 下列目錄是從 .unitypackage 匯入的目錄：

• Assets/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. 下載最新版 .unitypackage 發布新版本
2. 選取 Unity 選單選項，匯入 .unitypackage 檔案 素材資源 >匯入套件 >自訂套件並匯入所有項目。

納入外部依附元件

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

重要事項：請使用最新版 Google Mobile Ads SDK ，就能使用所有隱私權法規遵循功能。

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

Android

前往「專案設定」>播放器 >Android >發布設定 >版本 然後選取：

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

在 Unity 編輯器中，依序選取「Assets」(資產) >「外部依附元件管理員 >Android 版 解析器 >解決，取得 Unity External Dependency Manager 程式庫 將宣告的依附元件複製到 Assets/Plugins/Android 目錄 您的 Unity 應用程式

iOS

iOS 版 Unity 使用 CocoaPods 來識別及管理依附元件。 請參閱 CocoaPods 說明文件 與 iOS 相關的具體需求或疑難排解步驟 依附元件

下方列出了 Google 行動廣告 Unity 外掛程式依附元件： Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml。

設定 AdMob 應用程式 ID

在 Unity 編輯器中，依序選取「Assets」(資產) >「Google 行動廣告 >設定 。

在各個欄位中輸入 Android 和 iOS 的 AdMob 應用程式 ID 。

初始化 SDK

載入廣告前，請先設定應用程式初始化 Google Mobile Ads SDK，方法是： 正在撥打 MobileAds.Initialize()。這項操作只需執行一次 (理想情況下) 應用程式啟動時。

警告： Google Mobile Ads SDK 或中介服務合作夥伴可預先載入廣告 呼叫 MobileAds.Initialize() 時呼叫的 SDK。如需向 請為歐洲經濟區 (EEA) 的使用者設定所有要求專用標記，例如 格式：tagForChildDirectedTreatment 或 tag_for_under_age_of_consent，或 或是在載入廣告前採取行動請務必在 初始化 Google Mobile Ads SDK。

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

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

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

選取廣告格式

如今，您在將 Unity 應用程式部署至 Android 或 iOS 平台時，Google Mobile Ads SDK 也會一併納入。您現在可以開始導入廣告了。AdMob 提供多種廣告格式 您可以挑選 以獲得最佳使用者體驗

橫幅廣告

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

導入橫幅廣告

插頁式

插頁式廣告單元會在您應用程式中顯示全頁廣告。自然地展示 例如應用程式介面的破關和轉場效果 看看如何製作新的遊戲廣告

導入插頁式廣告

原生

原生廣告可讓您自訂應用程式中廣告標題和行動號召等素材資源的呈現方式。自行設定廣告樣式 製作不會突兀的自然廣告簡報，並加入內容豐富的使用者 無須專人管理

導入原生廣告

已獲得獎勵

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

導入獎勵廣告

插頁式獎勵廣告

插頁式獎勵廣告是一種全新的獎勵廣告格式 透過自動顯示的廣告提供獎勵，例如金幣或額外生命 在應用程式自然轉換點中運作時

與獎勵廣告不同的是，使用者不需要選擇觀看獎勵廣告 插頁式廣告。

在獎勵廣告中不會顯示選擇觀看提示，插頁式獎勵廣告並不會顯示 說明獎勵的簡介畫面，並讓使用者選擇是否要 自己想要做的事

導入插頁式獎勵廣告

應用程式開啟頁面廣告

應用程式開啟頁面廣告是一種廣告格式，會在使用者開啟或切換回應用程式時顯示 應用程式。廣告會重疊在載入畫面。

導入應用程式開啟頁面廣告