分享您的意見,協助我們打造 Google Mobile Ads SDK 的藍圖。請在 2023 年 5 月 5 日以前完成 Google Mobile Ads SDK 2023 年年度問卷調查

開始使用

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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

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

必要條件

下載行動廣告 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 目錄中。

iOS

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

  • 使用 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。這只需要在應用程式啟動時執行一次。

以下範例說明如何在附加至 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);
    }