開始使用

這份指南的適用對像是想透過 Unity 應用程式營利的發布者，

您需先將 Google 行動廣告 Unity 外掛程式整合至應用程式，以便刊登 AdMob 廣告和賺取收益。整合完成後，您可以選擇廣告格式 (例如原生或獎勵影片)，以便取得詳細的導入步驟。

必要條件

• 使用 Unity 2019 以上版本
• 部署至 iOS
  • Xcode 13.2.1 或更高版本
  • 指定 iOS 10.0 以上版本
  • CocoaPods
• 部署至 Android
  • Google Play 服務 18.1.0 以上版本
  • 指定 Android API 級別 16 以上版本
• 建議做法：建立 AdMob 帳戶 並註冊 Android 和/或 iOS 應用程式

下載行動廣告 Unity 外掛程式

Google 行動廣告 Unity 外掛程式可讓 Unity 開發人員輕鬆在 Android 和 iOS 應用程式中放送 Google 行動廣告，不用撰寫 Java 或 Objective-C 程式碼。這個外掛程式提供 C# 介面，用於請求 Unity 專案中 C# 指令碼所使用的廣告。

請使用下方連結下載外掛程式的 Unity 套件，或在 GitHub 上查看其程式碼。

下載外掛程式 查看原始碼

匯入行動廣告 Unity 外掛程式

在 Unity 編輯器中開啟專案。依序選取「Asset」>「Import Package」>「Custom Package」，然後找出您下載的 GoogleMobileAdsPlugin.unitypackage 檔案。

確認已選取所有檔案，然後按一下 [匯入]。

加入 Mobile Ads SDK

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

請按照下列步驟，確保您的專案包含 Mobile Ads SDK。

Android

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

注意： Google 行動廣告 Unity 外掛程式依附元件列於 Assets/GoogleMobileAds/Editor/GoogleMobileAdsDependencies.xml

iOS

不用再進行其他步驟，即可將 Mobile Ads SDK 加進 Unity 專案。

注意： iOS 依附元件是透過 CocoaPods 識別。CocoaPods 會在建構後的步驟中執行。

• 使用 Unity 5.6 以上版本時，系統會產生 Xcworkspace，其中包含必要的依附元件程式庫。使用產生的 xcworkspace，而非標準 Xcode 專案。
• 使用舊版 Unity 時，依附元件會包含在標準 Xcode 專案中。

設定 AdMob 應用程式 ID

在 Unity 編輯器中，從選單中選取 [Assets] > [Google Mobile Ads] > [Settings]。

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

初始化 Mobile Ads SDK

載入廣告之前，請呼叫 MobileAds.Initialize() 讓應用程式初始化 Mobile Ads SDK。這只需要在應用程式啟動時執行一次。

警告： Mobile Ads SDK 或中介服務合作夥伴 SDK 會在呼叫 MobileAds.Initialize() 後預先載入廣告。如需取得歐洲經濟區 (EEA) 使用者的同意聲明，請設定任何請求專用的標記 (例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent)，或是在載入廣告前先採取行動。請務必先完成行動廣告 SDK 的初始化作業。

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

...
using GoogleMobileAds.Api;
...
public class GoogleMobileAdsDemoScript : MonoBehaviour
{
    public void Start()
    {
        // When true all events raised by GoogleMobileAds will be invoked
        // on the Unity main thread. The default value is false.
        MobileAds.RaiseAdEventsOnUnityMainThread = true;

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(initStatus => { });
    }
}

如果您正在使用中介服務，請等到回呼完成後再載入廣告，才能確保所有中介服務轉接程式都已初始化。

選取廣告格式

現在當您部署到 Android 或 iOS 平台時，Unity 應用程式現在已包含 Mobile Ads SDK。您現在可以開始放送廣告。AdMob 提供多種廣告格式，您可以選擇最貼近您使用者需求的廣告格式。

橫幅

橫幅廣告是一種矩形圖像或文字廣告，會在應用程式版面配置中顯示。當使用者與應用程式互動時，這些畫面會持續顯示在畫面上，並且可在一段時間後自動重新整理。如果是行動廣告新手，建議從這裡著手。

導入橫幅廣告

插頁式

插頁式廣告是一種全螢幕廣告，會在使用者關閉應用程式前顯示其應用程式介面。在應用程式執行流程中的自然暫停階段 (例如遊戲關卡之間或完成任務後)，它們都最適合使用。

導入插頁式廣告

原生

原生是一種元件廣告格式，可讓您自訂素材資源 (例如廣告標題和行動號召) 在應用程式上的顯示方式。為自己選擇字型、顏色和其他詳細資料，即可建立自然而不突兀的廣告呈現方式，為使用者帶來豐富的體驗。

導入原生廣告

已獲得獎勵

獎勵影片廣告是全螢幕影片廣告，可讓使用者選擇觀看完整影片，換取應用程式內獎勵。

導入獎勵廣告

要求應用程式追蹤透明度驗證

若要顯示用來存取廣告識別碼的資訊追蹤透明度 (ATT) 授權要求，請使用 Unity 的 iOS 14 廣告支援套件。

相同應用程式金鑰

先決條件：Google 行動廣告 Unity 外掛程式 6.1.0 或更新版本

Google Mobile Ads SDK 推出了相同應用程式金鑰，可讓您利用使用者所用應用程式收集到的資料，放送更切合需求的個人化廣告。

相同應用程式金鑰預設為啟用，但您可以透過以下 API 停用：

public void Start()
    {
        RequestConfiguration requestConfiguration =
            new RequestConfiguration.Builder()
            .SetSameAppKeyEnabled(true).build();
        MobileAds.SetRequestConfiguration(requestConfiguration);

        // Initialize the Google Mobile Ads SDK.
        MobileAds.Initialize(HandleInitCompleteAction);
    }