在 Android 專案中開始使用 AdMob

本快速入門指南適用於想使用 AdMob 為採用 Firebase 建構的應用程式創造收益的發布商和開發人員。如果您不打算在應用程式中加入 Firebase，請改為參閱 獨立 AdMob 指南。

如果您尚未使用 AdMob、Firebase 和 Google Analytics 搭配使用，請參閱這篇文章，瞭解搭配使用這三項服務的所有優點。

事前準備

  • 如果您尚未建立 Firebase 專案和 Firebase 應用程式，請參閱 Firebase 入門指南： 將 Firebase 新增至 Android 專案。

  • 確認已在 Firebase 專案中啟用 Google Analytics：

    • 如果您要建立新的 Firebase 專案，請在專案建立工作流程中啟用 Google Analytics。

    • 如果您現有的 Firebase 專案未啟用 Google Analytics，可以前往 >「專案設定」的「整合」分頁標籤啟用 Google Analytics。

步驟 1：在 AdMob 帳戶中設定應用程式

  1. 將應用程式註冊為 AdMob 應用程式。

    1. 登入或註冊 AdMob 帳戶。

    2. 使用 AdMob 註冊應用程式。這個步驟會建立 AdMob 應用程式，並提供您稍後在本指南中需要的專屬 AdMob 應用程式 ID。

    系統會要求您將 Mobile Ads SDK 新增至應用程式。請參閱本指南稍後的部分，瞭解這項工作的詳細操作說明。

  2. 將 AdMob 應用程式連結至 Firebase 應用程式。

    這是選用步驟，但強烈建議執行。進一步瞭解啟用使用者指標並將 AdMob 應用程式連結至 Firebase 的優點。

    在 AdMob 帳戶的「應用程式」資訊主頁中，完成以下兩個步驟：

    1. 啟用使用者指標，允許 AdMob 處理及顯示 AdMob 帳戶中的精選數據分析資料。該項設定也必須將 AdMob 應用程式連結至 Firebase。

    2. 將 AdMob 應用程式連結至現有的 Firebase 專案和 Firebase 應用程式。

      請務必輸入與您在 Firebase 應用程式輸入的套件名稱相同。依序前往 >「Project settings」，在「Your apps」資訊卡中找到 Firebase 應用程式的套件名稱。

步驟 2：將 AdMob App ID 新增至 AndroidManifest.xml 檔案

如要將 AdMob App ID 新增至應用程式的 AndroidManifest.xml 檔案，請新增 <meta-data> 標記，如下所示。

<manifest>
    <application>
        <!-- Sample AdMob App ID: ca-app-pub-3940256099942544~3347511713 -->
        <meta-data
            android:name="com.google.android.gms.ads.APPLICATION_ID"
            android:value="ADMOB_APP_ID"/>
    </application>
</manifest>

步驟 3：新增及初始化 Mobile Ads SDK

  1. 將 Google Mobile Ads SDK 的依附元件新增至模組 (應用程式層級) Gradle 檔案 (通常是 <project>/<app-module>/build.gradle.kts 或 <project>/<app-module>/build.gradle)：

    implementation("com.google.android.gms:play-services-ads:23.5.0")

  2. 請在載入廣告前呼叫 MobileAds.initialize() 方法。

    這個呼叫會初始化 SDK，並在初始化完成後 (或 30 秒逾時後) 回呼完成事件監聽器。請盡早呼叫此方法一次，最好是在應用程式啟動時。

    以下範例說明如何在活動中呼叫 initialize() 方法：

    Kotlin+KTX 

    override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...
    MobileAds.initialize(this)
}
    MainActivity.kt

    Java 

    @Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    MobileAds.initialize(this);
}
    MainActivity.java

步驟 4：查看使用者指標和數據分析資料

初始化完成後，Mobile Ads SDK 就會自動開始記錄應用程式中的數據分析事件和使用者屬性。您無須在應用程式中新增任何額外程式碼或導入廣告，即可查看這類資料。您可以透過下列方式查看這些數據分析資料：

請注意，為更準確呈現ARPU 和 ARPPU 指標，您可能需要在這些指標的收益計算中納入名為 ecommerce_purchase 的 Analytics 自訂 事件資料 (瞭解如何操作)。

步驟 5： (選用) 使用更多 Google Analytics 和 Firebase 功能

善用更多商機和功能，提升應用程式營利成效和使用者參與度：

  • 新增及使用 Google Analytics 專用的 Firebase SDK

    如要進一步瞭解，請參閱搭配使用 Google Analytics 和 Firebase 與 AdMob 應用程式的相關指南。

  • 在應用程式中使用其他 Firebase 產品

    新增 Google Analytics 專用 Firebase SDK 後，請使用其他 Firebase 產品來改善應用程式中的廣告。

    • Remote Config 可讓您免費變更應用程式的行為和外觀，且無須發布應用程式更新，並可讓無限數量的每日活躍使用者存取。

    • A/B Testing 可讓您測試對應用程式使用者介面、功能或參與度廣告活動所做的變更，以在廣泛實作之前，瞭解變更是否確實能對關鍵指標 (例如收益和留存率) 發揮效用。

  • 最佳化應用程式的廣告營利

    先對一小群使用者嘗試不同的廣告格式或設定，然後根據資料做出決策，為所有使用者導入廣告。如要進一步瞭解，請參閱下列教學課程：

步驟 6：選擇要在應用程式中導入的廣告格式

AdMob 提供多種不同的廣告格式，方便您選擇最適合應用程式使用者體驗的格式。按一下廣告格式的按鈕，即可在 AdMob 說明文件中查看詳細的導入操作說明。

這類矩形廣告會顯示在裝置畫面頂端或底部

使用者與應用程式互動時，橫幅廣告會停留在畫面上，且經過一段時間後會自動重新整理。如果你是行動廣告新手，建議從這裡著手。

導入橫幅廣告

插頁式

全螢幕廣告會覆蓋應用程式的介面，直到使用者關閉為止

插頁式廣告最適合用於應用程式執行流程中的自然暫停狀態，例如遊戲關卡之間，或遊戲完成後才執行。

導入插頁式廣告

原生

符合應用程式外觀和風格的可自訂廣告

原生廣告是以元件為基礎的廣告格式。您可以決定原生廣告的顯示方式和位置，讓版面配置與應用程式設計更加一致。只要自行選擇字型、顏色和其他詳細資料，就能建立自然又不突兀的廣告簡報，加入豐富的使用者體驗。

導入原生進階廣告

獎勵廣告

在使用者看完短片、與可試玩廣告及問卷調查互動後提供獎勵的廣告

獎勵廣告 (又稱「獎勵型」) 廣告可協助透過免費遊戲使用者營利。

導入獎勵廣告 導入獎勵廣告 (新版 API)