開始使用

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」>播放器 > Android >其他設定 >其他設定。

匯入 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 新增為「套件管理員」視窗的限定範圍登錄檔：

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

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

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

  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 專案

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

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。

設定 Ad Manager 應用程式 ID

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

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

初始化 SDK

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

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

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

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

選取廣告格式

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

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

導入橫幅廣告

插頁式

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

導入插頁式廣告

原生

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

導入原生廣告

已獲得獎勵

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

導入獎勵廣告