在您的 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。
注意：將適用於 Google Analytics 的 Firebase SDK 添加到您的應用是可選的，但強烈建議您這樣做。詳細了解添加適用於 Google Analytics 的 Firebase SDK 的優勢。

第 1 步：在 AdMob 帳戶中設置您的應用

將您的應用註冊為 AdMob 應用。
1. 登錄或註冊AdMob 帳戶。
2. 向 AdMob 註冊您的應用。此步驟將創建一個帶有唯一AdMob 應用 ID 的AdMob 應用，您將在本指南的後面部分用到該 ID。
系統會要求您將移動廣告 SDK 添加到您的應用中。在本指南的後面部分中查找有關此任務的詳細說明。
將您的 AdMob 應用鏈接到您的 Firebase 應用。
此步驟是可選的，但強烈建議這樣做。詳細了解啟用用戶指標並將 AdMob 應用關聯到 Firebase 的好處。
在 AdMob 帳戶的應用信息中心中完成以下兩個步驟：
1. 啟用用戶指標以允許 AdMob 處理並顯示您 AdMob 帳戶中的精選分析數據。這也是將 AdMob 應用鏈接到 Firebase 所必需的設置。
2. 將您的 AdMob 應用鏈接到現有的 Firebase 項目和 Firebase 應用。
  確保您輸入的包名稱與您為 Firebase 應用輸入的包名稱相同。在 >項目設置的您的應用卡中找到 Firebase 應用的包名稱。

第 2 步：將 AdMob 應用 ID 添加到`AndroidManifest.xml`文件中

通過添加<meta-data>標記，將您的AdMob 應用 ID添加到應用的AndroidManifest.xml文件中，如下所示。

<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：添加並初始化移動廣告 SDK

將 Google 移動廣告 SDK 的依賴項添加到模塊（應用級） Gradle 文件（通常<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle ）：
```
implementation("com.google.android.gms:play-services-ads:22.4.0")
```
在加載廣告之前，請調用MobileAds.initialize()方法。
此調用會初始化 SDK，並在初始化完成後（或 30 秒超時後）回調完成偵聽器。僅調用此方法一次，並且盡可能早，最好是在應用程序啟動時調用。
警告：移動廣告 SDK 或中介合作夥伴 SDK 可能會在調用MobileAds.initialize()時預加載廣告。如果您需要在加載廣告之前執行任何操作，請確保在初始化移動廣告 SDK 之前執行此操作。以下是初始化之前可能需要執行的一些操作示例：
- 獲得歐洲經濟區 (EEA) 用戶的同意
- 設置任何特定於請求的標誌（例如tagForChildDirectedTreatment或tag_for_under_age_of_consent ）
請參閱AdMob 文檔了解更多信息。
以下是如何在活動中調用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 步：查看用戶指標和分析數據

初始化後，移動廣告 SDK 會自動開始記錄應用程序中的分析事件和用戶屬性。您無需向應用添加任何額外代碼或實施任何廣告即可查看此數據。您可以在此處查看此分析數據：

在 AdMob 帳戶的用戶指標卡（主頁或應用程序信息中心）中，您可以查看從收集的分析數據中得出的精選用戶指標，例如平均會話持續時間、 ARPU和保留率。
在 Firebase 控制台的Analytics儀表板中，您可以查看關鍵指標的聚合統計數據和摘要。如果您添加適用於 Google Analytics 的 Firebase SDK ，您還可以在 Firebase 控制台中標記廣告系列的轉化並構建自定義受眾群體。

請注意，為了更好地表示ARPU和ARPPU指標，您可能希望在這些指標的收入計算中包含來自名為ecommerce_purchase的分析自定義事件的數據（了解操作方法）。

第 5 步：（可選）使用 Google Analytics 和 Firebase 的更多功能

利用更多機會和功能來提高應用貨幣化和用戶參與度：

添加並使用適用於 Google Analytics 的 Firebase SDK
- 在您的應用程序中實現自定義事件日誌記錄。
- 標記自定義廣告活動的轉化。
- 在ARPU和ARPPU指標的收入計算中包含ecommerce_purchase事件數據。
要了解更多信息，請訪問將Google Analytics 和 Firebase 與 AdMob 應用結合使用的指南。
在您的應用中使用其他 Firebase 產品
添加適用於 Google Analytics 的 Firebase SDK 後，可以使用其他 Firebase 產品來優化應用中的廣告。
- 遠程配置使您能夠更改應用程序的行為和外觀，而無需為無限的每日活躍用戶免費發布應用程序更新。
- A/B 測試使您能夠測試應用程序 UI、功能或參與活動的更改，以了解它們是否對您的關鍵指標（例如收入和保留率）產生影響，然後再廣泛推廣更改。