在 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 為選用步驟，但強烈建議您這麼做。進一步瞭解加入 Firebase SDK for 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. 將應用程式連結至現有的 Firebase 專案和 Firebase 應用程式。AdMob

      請務必輸入與 Firebase 應用程式相同的套件名稱。如要查看 Firebase 應用程式的套件名稱，請依序前往 >「您的應用程式」資訊卡 >「專案設定」。

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

將AdMob應用程式 ID新增至應用程式的 AndroidManifest.xml 檔案，方法是新增 <meta-data> 標記，如下所示。

重要事項： 自 Google Mobile Ads SDK 17.0.0 版起，您必須執行這個步驟。如果未加入這個 <meta-data> 標記，應用程式會當機並顯示以下訊息： "The Google Mobile Ads SDK was initialized incorrectly."

<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:24.7.0")
   

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

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

   警告：呼叫 MobileAds.initialize() 時，Mobile Ads SDK 或中介服務合作夥伴 SDK 可能會預先載入廣告。如果在載入廣告之前需要執行任何操作，請確保在初始化 Mobile Ads SDK 之前執行該操作。以下是一些初始化之前可能需要執行的操作範例：

   • 獲得歐洲經濟區 (EEA) 用戶的同意
   • 設定任何請求特定的標誌（例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent）

   請參閱AdMob文件以瞭解更多資訊。

   以下是如何在 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 控制台的數據分析資訊主頁中，您可以查看匯總統計資料和重要指標摘要。如果你添加 Firebase SDKGoogle Analytics你也可以廣告活動轉換率和建立自訂受眾群體在Firebase安慰。

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

數據通常會在一小時內顯示，但最長可能需要 48 小時才能顯示。

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

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

• 新增並使用 Firebase SDK 以進行 Google Analytics

  • 在您的應用程式中實作自訂事件日誌記錄。

  • 標記 個自訂廣告活動的轉換率。

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

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

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

  新增 Google Analytics 適用的 Firebase SDK 後，即可使用其他 Firebase 產品，進一步提升應用程式中的廣告效益。

  • Remote Config 可讓您直接變更應用程式行為和外觀 (不用發布應用程式更新)，而且不限每日活躍使用者人數，完全免費。

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

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

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

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

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

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

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

橫幅

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

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

導入橫幅廣告

插頁式

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

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

導入插頁式廣告

原生

可自訂的廣告，外觀和風格與應用程式一致

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

導入原生進階廣告

獎勵廣告

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

獎勵廣告 (或「以獎勵為基礎」的廣告) 有助於透過免費遊戲使用者營利。

導入獎勵廣告

導入獎勵廣告 (新版 API)