在 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 > 「Project settings」(專案設定) 的 「Integrations」(整合) 分頁啟用 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 >「Project settings」 ，然後查看「Your apps」資訊卡。

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

請在應用程式的 AndroidManifest.xml 檔案中，加入 <meta-data> 標記，並填入 AdMob 應用程式 ID，如下所示。

<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 帳戶的「使用者指標」資訊卡 (「首頁」或「應用程式」資訊主頁) 中，您可以查看根據收集到的數據分析資料，整理出的使用者指標，例如平均工作階段持續時間、每位使用者的平均收益和留存率。

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

請注意，為了更準確地呈現 ARPU 和 ARPPU 指標，您可能需要在這些指標的收益計算中，納入名為 ecommerce_purchase 的 Analytics 自訂事件資料 (瞭解詳情)。

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

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

• 新增並使用 Google Analytics 專用 Firebase SDK

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

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

  • 在 ARPU 和 ARPPU 指標的收益計算中，納入 ecommerce_purchase 事件資料。

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

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

  新增 Google Analytics 專用 Firebase SDK 後，您可以使用其他 Firebase 產品，對應用程式中的廣告進行最佳化。

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

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

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

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

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

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

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

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

橫幅

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

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

插頁式

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

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

原生

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

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

獎勵廣告

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

獎勵廣告 (或「獎勵制」廣告) 可協助您透過免付費玩遊戲的使用者營利。