在 Android 專案中開始使用 AdMob

本快速入門指南適用於想使用 AdMob，透過以 Firebase 建構的應用程式營利的發布商和開發人員。如果不想在應用程式中導入 Firebase，請改為參閱獨立AdMob指南。

如果您尚未瞭解，請參閱這篇文章，瞭解如何搭配使用 AdMob、Firebase 和 Google Analytics。

事前準備

• 如果您還沒有 Firebase 專案和 Firebase 應用程式，請按照 Firebase 入門指南操作： 將 Firebase 新增至 Android 專案。

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

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

  • 如果您現有的 Firebase 專案未啟用 Google Analytics，可以前往 settings >「專案設定」的「整合」分頁標籤啟用 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 應用程式的套件名稱，請依序前往「settings」>「專案設定」，然後在「您的應用程式」資訊卡中查看。

步驟 2：將 AdMob 應用程式 ID 新增至 AndroidManifest.xml 檔案

將您的AdMob應用程式 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:25.5.0")
   

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

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

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

   Kotlin

   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 會自動開始記錄應用程式的分析事件和使用者屬性。您不必在應用程式中新增任何程式碼或導入任何廣告，就能查看這項資料。您可以在下列位置查看這項數據分析資料：

• 在 AdMob 帳戶的「使用者指標」資訊卡 (「首頁」或「應用程式」資訊主頁)，您可以查看從收集到的數據分析資料得出的精選使用者指標，例如平均工作階段持續時間、每位使用者的平均收益 (ARPU)和留存率。

• 在 Firebase 控制台的「Analytics」資訊主頁中，您可以查看匯總統計資料和重要指標摘要。如果您新增 Google Analytics 適用的 Firebase SDK，也可以在 Firebase 控制台中標記廣告活動的轉換，以及建立自訂目標對象。

請注意，如要更準確地呈現每位使用者的平均收益和單一付費使用者平均收益指標，您可能需要在這些指標的收益計算中，納入名為 ecommerce_purchase 的 Analytics 自訂事件資料 (瞭解如何操作)。

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

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

• 新增及使用 Firebase SDK for Google Analytics

  • 在應用程式中導入自訂事件記錄。

  • 為自訂廣告活動標示轉換。

  • 在每位使用者的平均收益 (ARPU) 和單一付費使用者平均收益 (ARPPU) 指標的收益計算中，納入 ecommerce_purchase 事件資料。

  詳情請參閱搭配使用 Google Analytics 和 Firebase 應用程式AdMob的指南。

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

  加入 Google Analytics 專用的 Firebase SDK 後，即可使用其他 Firebase 產品，在應用程式中放送最佳化廣告。

  • Remote Config 可讓您變更應用程式的行為和外觀，不必發布應用程式更新。

  • A/B Testing 可讓您測試應用程式 UI、功能或參與度廣告活動的變更，在廣泛推出變更前，瞭解變更是否會影響主要指標 (例如收益和留存率)。

• 提升應用程式的廣告營利成效

  對一小部分使用者測試不同的廣告格式或設定，然後根據資料決定是否向所有使用者放送廣告。如要瞭解詳情，請參閱下列教學課程：

  • 測試採用新廣告格式 (總覽 | 導入)。

  • 最佳化廣告展示頻率 (總覽 | 導入程序)。

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

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

橫幅

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

使用者操作應用程式時，橫幅廣告會持續停留在畫面上，並能定時自動更新內容。對剛接觸行動廣告的新手來說，這是很好的入門選擇。

插頁式

完全覆蓋應用程式介面的全螢幕廣告，使用者需自行關閉

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

原生

可自訂的廣告，能融入應用程式外觀與風格

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

獎勵廣告

這類廣告能在使用者看完短片、與可試玩廣告互動，或完成問卷調查後提供獎勵

獎勵廣告 (或「以獎勵為基礎」的廣告) 可協助您向免付費玩遊戲的使用者放送廣告，藉此營利。