在您的 Android 項目中開始使用 AdMob

本快速入門指南適用於希望使用 AdMob 通過使用 Firebase 構建的應用獲利的發布商和開發者。如果您不打算在您的應用中包含 Firebase，請訪問獨立的 AdMob 指南。

如果您還沒有，請了解結合使用 AdMob、Firebase 和 Google Analytics 的所有好處。

在你開始之前

如果您還沒有 Firebase 項目和 Firebase 應用，請按照 Firebase 入門指南：將 Firebase 添加到您的 Android 項目。
確保在您的 Firebase 項目中啟用了 Google Analytics：
- 如果您要創建新的 Firebase 項目，請在項目創建工作流程中啟用 Google Analytics。
- 如果您有一個未啟用 Google Analytics 的現有 Firebase 項目，您可以從 >項目設置的集成選項卡中啟用 Google Analytics。
注意：將 Firebase SDK for Google Analytics 添加到您的應用是可選的，但強烈建議您這樣做。詳細了解添加 Firebase SDK for Google Analytics 的好處。

第 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 Mobile Ads SDK 的依賴項添加到您應用的模塊（應用級） build.gradle文件中：
```
implementation 'com.google.android.gms:play-services-ads:21.0.0'
```
在加載廣告之前，調用MobileAds.initialize()方法。
此調用初始化 SDK 並在初始化完成後（或在 30 秒超時後）回調完成偵聽器。盡可能早地調用此方法一次，最好在應用程序啟動時調用。
警告：移動廣告 SDK 或中介合作夥伴 SDK 在調用MobileAds.initialize()時可能會預加載廣告。如果您需要在加載廣告之前執行任何操作，請確保在初始化移動廣告 SDK 之前執行此操作。以下是初始化之前可能需要的一些操作示例：
- 獲得歐洲經濟區 (EEA) 用戶的同意
- 設置任何特定於請求的標誌（例如tagForChildDirectedTreatment或tag_for_under_age_of_consent ）
在AdMob 文檔中了解更多信息。
下面是一個如何在 Activity 中調用initialize()方法的示例：
Java
```
@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // ...
    MobileAds.initialize(this);
}MainActivity.java
```
Kotlin+KTX
```
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // ...
    MobileAds.initialize(this)
}MainActivity.kt
```

第 4 步：查看用戶指標和分析數據

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

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

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

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

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

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