開始使用

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。

設定 AdMob 應用程式 ID

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

請輸入 Android 和 iOS 裝置 AdMob 應用程式 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 提供多種廣告格式 您可以挑選 以獲得最佳使用者體驗

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

導入橫幅廣告

插頁式

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

導入插頁式廣告

原生

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

導入原生廣告

已獲得獎勵

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

導入獎勵廣告

插頁式獎勵廣告

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

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

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

導入插頁式獎勵廣告

應用程式開啟頁面廣告

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

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