開始在 Android 專案中使用 AdMob

本快速入門指南適用於想要使用 AdMob 透過 Firebase 建置的應用程式獲利的發布商和開發者。如果您不打算在應用程式中包含 Firebase，請造訪獨立的 AdMob 指南。

如果您還沒有了解同時使用 AdMob、Firebase 和 Google Analytics（分析）的所有優勢，請了解一下。

在你開始之前

• 如果您還沒有 Firebase 專案和 Firebase 應用，請按照 Firebase 入門指南：將 Firebase 新增到您的 Android 專案。

• 確保您的 Firebase 專案中啟用了 Google Analytics：

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

  • 如果您的現有 Firebase 專案未啟用 Google Analytics（分析），您可以從您的 Firebase 專案的「整合」標籤中啟用 Google Analytics。 settings >項目設定。

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

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

   1. 登入或註冊AdMob 帳戶。

   2. 向 AdMob 註冊您的應用程式。此步驟將建立一個帶有唯一AdMob 應用程式 ID 的AdMob 應用，您將在本指南的後面部分使用到該 ID。

   系統會要求您將行動廣告 SDK 新增到您的應用程式中。在本指南的後面部分中尋找有關此任務的詳細說明。

2. 將您的 AdMob 應用程式連結到您的 Firebase 應用程式。

   此步驟是可選的，但強烈建議這樣做。詳細了解啟用使用者指標並將 AdMob 應用程式關聯到 Firebase 的好處。

   在 AdMob 帳戶的應用程式資訊中心中完成以下兩個步驟：

   1. 啟用使用者指標以允許 AdMob 處理並顯示您 AdMob 帳戶中的精選分析資料。這也是將 AdMob 應用程式連結到 Firebase 所必需的設定。

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

      確保您輸入的套件名稱與您為 Firebase 應用程式輸入的套件名稱相同。在您的 Firebase 應用程式的「您的應用程式」卡中找到您的 Firebase 應用程式的套件名稱settings >項目設定。

步驟 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

1. 將 Google 行動廣告 SDK 的依賴項新增至模組（應用程式等級） Gradle 檔案（通常<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle ） ：

   implementation("com.google.android.gms:play-services-ads:22.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 步：查看使用者指標和分析數據

初始化後，行動廣告 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、功能或參與活動的更改，以了解它們是否對您的關鍵指標（例如收入和保留率）產生影響，然後再廣泛推廣更改。

• 優化您的應用程式的廣告獲利

  與一小部分使用者嘗試不同的廣告格式或配置，然後做出有關為所有使用者實施廣告的數據驅動決策。要了解更多信息，請查看以下教程：

  • 測試新廣告格式的採用（概述|實施）。

  • 優化廣告頻率（概述|實施）。

第 6 步：選擇要在您的應用程式中實施的廣告格式

AdMob 提供多種不同的廣告格式，因此您可以選擇最適合應用程式使用者體驗的格式。點擊廣告格式的按鈕即可查看 AdMob 文件中的詳細實施說明。

橫幅

顯示在裝置螢幕頂部或底部的矩形廣告

當用戶與應用程式互動時，橫幅廣告會保留在螢幕上，並且可以在一段時間後自動刷新。如果您是行動廣告新手，那麼它們是一個很好的起點。