在 Android 專案中開始使用 AdMob

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

如果您尚未準備好，不妨進一步瞭解搭配使用 AdMob、Firebase 和 Google Analytics (分析) 的所有優點。

事前準備

• 如果您尚未建立 Firebase 專案和 Firebase 應用程式，請參閱 Firebase 入門指南： 將 Firebase 新增至 Android 專案。

• 請確認您的 Firebase 專案已啟用 Google Analytics (分析)：

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

  • 如果現有的 Firebase 專案尚未啟用 Google Analytics (分析)，您可以前往 >「Project settings」(專案設定) 的「Integrations」(整合) 分頁啟用 Google Analytics (分析)。

  注意： 您可以選擇是否將 Google Analytics (分析) 專用 Firebase SDK 加進應用程式，但強烈建議這麼做。進一步瞭解加入 Google Analytics (分析) 專用 Firebase SDK 的好處。

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

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

   1. 登入或註冊 AdMob 帳戶。

   2. 向 AdMob 註冊應用程式。這個步驟會使用專屬的 AdMob 應用程式 ID 建立 AdMob 應用程式，本指南稍後會用到。

   系統會要求您在應用程式中加入 Mobile Ads SDK。如需這項工作的詳細操作說明，請參閱本指南。

2. 將 AdMob 應用程式連結至 Firebase 應用程式。

   這是選擇性步驟，但強烈建議執行。進一步瞭解啟用使用者指標並將 AdMob 應用程式連結至 Firebase 的優點。

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

   1. 啟用使用者指標，以便 AdMob 在您的 AdMob 帳戶中處理及顯示精選分析資料。這也是將 AdMob 應用程式連結至 Firebase 的必要設定。

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

      請務必輸入與您在 Firebase 應用程式輸入的套件名稱相同。依序前往 >「Project settings」，在「Your apps」資訊卡中找到 Firebase 應用程式的套件名稱。

步驟 2：在 AndroidManifest.xml 檔案中加入 AdMob 應用程式 ID

加入 <meta-data> 標記，將 AdMob 應用程式 ID 加進應用程式的 AndroidManifest.xml 檔案，如下所示。

重要事項： 自 Google Mobile Ads SDK v17.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:23.1.0")
   

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

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

   警告：呼叫 MobileAds.initialize() 時，Mobile Ads SDK 或中介服務合作夥伴 SDK 可能會預先載入廣告。如果您在載入廣告前需要採取任何行動，請務必先完成這項作業，再初始化 Mobile Ads SDK。以下列舉幾個進行初始化時可能需要採取的行動：

   • 取得歐洲經濟區 (EEA) 使用者的同意聲明
   • 設定任何要求專屬標記 (例如 tagForChildDirectedTreatment 或 tag_for_under_age_of_consent)

   詳情請參閱 AdMob 說明文件。

   以下範例說明如何在活動中呼叫 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 和回訪率。

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

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

資料通常會在一小時內顯示，但最多也可能需要 48 小時才會顯示。

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

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

• 新增及使用 Google Analytics (分析) 專用 Firebase SDK

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

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

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

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

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

  加入 Google Analytics (分析) 專用 Firebase SDK 後，您可以運用其他 Firebase 產品，將應用程式中的廣告最佳化。

  • 遠端設定功能可讓您變更應用程式的行為和外觀，而且不需針對每日活躍使用人數限制付費的應用程式更新。

  • 透過 A/B 測試，您可以測試對應用程式使用者介面、功能或參與度廣告活動所做的變更，瞭解這些變更是否影響了重要指標 (例如收益和留存率)，再廣泛實施異動。

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

  先對一小群使用者嘗試不同的廣告格式或設定，然後根據資料製定相關決策，為所有使用者導入廣告。詳情請參閱下列教學課程：

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

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

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

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

橫幅

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

橫幅廣告會在使用者與應用程式互動時持續顯示在畫面上，並在一段時間後自動重新整理。如果你是行動廣告新手，建議從這裡著手。

導入橫幅廣告

插頁式

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

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

導入插頁式廣告

原生

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

原生廣告是以元件為基礎的廣告格式。原生廣告的擺放方式和位置都由您決定，讓版面配置與應用程式設計保持一致。只要自行選擇字型、顏色和其他詳細資料，就能建立自然又不突兀的廣告簡報，加入豐富的使用者體驗。

導入原生進階廣告

獎勵廣告

廣告會在使用者觀看短片、與可試玩廣告及問卷調查互動時發送獎勵

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

導入獎勵廣告

導入獎勵廣告 (新版 API)