在 Android 專案中開始使用 AdMob

本快速入門指南適用於想要使用 AdMob 的發布商和開發人員 透過以 Firebase 建構的應用程式營利 如果您不打算將 Firebase 納入應用程式，請前往 獨立 AdMob 指南。

如果您還不熟悉這個功能，請參閱 優點： 以及 Google Analytics

事前準備

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

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

  • 如要建立新的 Firebase 專案，請啟用 Google Analytics 專案建立流程

  • 如果您現有的 Firebase 專案沒有 您必須先啟用 Google Analytics 這個 整合 settings > 的分頁 專案設定。

步驟 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：在 AndroidManifest.xml 檔案中加入 AdMob 應用程式 ID

新增 AdMob 應用程式 ID ，方法是將 <meta-data> 標記新增為應用程式的 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：新增並初始化 Mobile Ads SDK

1. 將 Google Mobile Ads SDK 的依附元件加進 module (app-level) Gradle 檔案 (通常 <project>/<app-module>/build.gradle.kts或 <project>/<app-module>/build.gradle)：

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

初始化完成後，Mobile Ads SDK 就會自動啟動 記錄分析 事件和 使用者屬性 即可。您不必將任何其他程式碼加入 應用程式或導入任何廣告您可以在這裡查看這項數據分析資料：

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

• 在 Analytics 中 資訊主頁 您可以查看 Firebase 控制台的匯總統計資料和摘要 主要指標： 如果發生以下情況： 加入 Google Analytics 專用 Firebase SDK， 你也可以 將廣告活動的轉換標示為轉換 和 建立自訂目標對象 設定。

請注意，為了充分呈現 ARPU 和 ARPPU 指標，則 建議納入來自名為「自訂事件」的 Analytics 自訂事件資料 ecommerce_purchase 因此記錄了這些指標 (瞭解詳情)。

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

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

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

  • 導入自訂事件記錄功能 。

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

  • 包含 ecommerce_purchase 個事件 這些資料 計算有關 每位使用者的平均收益 (ARPU) 和 ARPPU 指標。

  詳情請參閱使用 Google Analytics 和 Firebase 的指南

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

  加入 Google Analytics 專用 Firebase SDK 後，使用其他 Firebase 來最佳化應用程式內廣告。

  • 遠端設定可讓您變更 但每日活躍使用者人數沒有上限。

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

• 最佳化應用程式廣告營利

  試著向一小群使用者嘗試不同的廣告格式或設定 然後根據資料製定決策 使用者。詳情請參閱下列教學課程：

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

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

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

AdMob 提供多種廣告格式，您可以 最適合應用程式的使用者體驗按下一種廣告格式後 請參閱 AdMob 說明文件，查看詳細的導入操作說明。

橫幅

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

橫幅廣告會在使用者與應用程式互動時持續顯示在畫面上， 並重新整理。如果你剛開始使用行動裝置 都是很好的起點

導入橫幅廣告

插頁式

全螢幕廣告會覆蓋應用程式介面，直到使用者關閉為止

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

導入插頁式廣告

原生

可根據應用程式外觀和風格的自訂廣告

原生廣告是以元件為基礎的廣告格式。原生廣告的使用方式和位置由您決定 能讓版面配置與應用程式設計保持一致。變更者： 自行選擇字型、顏色和其他細節 加入不突兀的廣告簡報，提供更豐富的使用者體驗。

導入原生進階廣告

獎勵廣告

在使用者觀看短片及與可試玩廣告互動時提供獎勵的廣告 廣告和問卷調查

獎勵廣告 (又稱「獎勵型」) 廣告可透過免費遊戲使用者營利。

導入獎勵廣告

導入獎勵廣告 (新版 API)