開始使用

Google 行動廣告 Unity 外掛程式可讓 Unity 開發人員放送 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 以上版本為目標

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

  1. 選取 Unity 選單選項「Edit」>「Project Settings」>「Package Manager」，開啟套件管理工具設定。

  2. 將 OpenUPM 新增為「套件管理員」視窗的限定範圍登錄檔：

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

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

  4. 設定管理員範圍下拉式選單，選取「My Registries」(我的註冊資料庫)。

  5. 從套件清單中選取「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 匯入

  1. 下載最新版 .unitypackage 發布新版本
  2. 依序選取 Unity 選單選項「Assets」>「Import package」>「Custom Package」，然後匯入所有項目，即可匯入 .unitypackage 檔案。

納入外部依附元件

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

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

Android

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

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

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

iOS

Unity for iOS 會使用 CocoaPods 來識別及管理依附元件。如需 iOS 依附元件相關的特定需求或疑難排解步驟，請參閱 CocoaPods 說明文件。

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

設定 Ad Manager 應用程式 ID

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

請輸入 Android 和 iOS 裝置 Ad Manager 應用程式 ID 各欄位中的值

初始化 SDK

在載入廣告之前，請透過呼叫 MobileAds.Initialize() 讓應用程式初始化 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 => { });
    }
}

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

選取廣告格式

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

橫幅廣告單元會占用應用程式的部分版面來顯示矩形廣告。且會固定在一段時間後自動重新整理。也就是說 使用者每隔一段時間就會看見新廣告 套用適當工具這種廣告格式的導入方式最簡單。

導入橫幅廣告

插頁式

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

導入插頁式廣告

原生

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

導入原生廣告

已獲得獎勵

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

導入獎勵廣告