在 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 應用程式相同。如要查看 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.6.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 的更多功能

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

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

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

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

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

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

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

導入橫幅廣告

插頁式

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

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

導入插頁式廣告

原生

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

原生廣告是以元件為基礎的廣告格式。您可以決定原生廣告的顯示方式和位置，讓版面配置與應用程式設計更加一致。您可以自行選擇字型、顏色和其他詳細資料，打造自然不顯眼的廣告呈現方式，為使用者帶來豐富的體驗。

導入原生進階廣告

獎勵廣告

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

獎勵廣告 (或稱「獎勵制廣告」) 可協助您透過免費遊戲玩家營利。

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