本頁面由 Cloud Translation API 翻譯而成。

Google Ads 與 Google Analytics for Firebase 自訂事件 - Android

1. 簡介

上次更新時間：2020 年 12 月 14 日

建構項目

在本程式碼研究室中，您將瞭解如何使用 Google Analytics for Firebase(GA4F) 導入事件，並透過 Google Ads 推出行動廣告活動。

本程式碼研究室著重於使用 GA4F 導入事件，以及將事件匯入 Google Ads。如要瞭解如何使用 Firebase 建構 Android 應用程式，請參閱「Firebase Android Codelab 建構友善即時通訊」。

課程內容

如何建立 Firebase 專案
如何在 Android 應用程式中導入 Firebase SDK
如何建立事件和參數。
如何將 Firebase 事件匯入 Google Ads
透過自訂事件推出 Google Ads 行動廣告活動。

軟硬體需求

Android Studio 3.6 以上版本
Firebase 帳戶
Google Ads 帳戶

2. 建立及設定 Firebase 專案

如要開始使用 Firebase，請建立並設定 Firebase 專案。

建立 Firebase 專案

登入 Firebase。

在 Firebase 控制台中，按一下「新增專案」(或「建立專案」)，然後視需要命名 Firebase 專案。

點選專案建立選項。如果系統顯示提示，請接受 Firebase 條款。您需要為這項專案啟用 Google Analytics，因為您需要使用 Google Analytics 事件來追蹤動作事件和轉換。

如要進一步瞭解 Firebase 專案，請參閱「瞭解 Firebase 專案」一文。

選擇「Google Analytics」帳戶。如果有的話，請新建一個。按一下「建立專案」按鈕。

Firebase 專案建構作業已完成！

在下一個步驟中，您將瞭解如何將 Firebase 新增至 Android 應用程式。

3. 將 Firebase 新增至您的 Android 應用程式

註冊應用程式

在 Firebase 控制台中，選取左側導覽列中的「專案總覽」，然後按一下「開始將 Firebase 新增至應用程式」下方的 Android 按鈕

填寫必要資訊。

針對 Android 套件名稱，在 Android Studio 中前往應用程式目錄，開啟檔案名稱 build.gradle。在檔案中搜尋 applicationId。這個值是 Android 套件名稱。複製貼上這個值。

除非您打算使用 Google 登入或 Firebase Dynamic Links，否則這裡不需要 SHA-1 金鑰。請注意，這些金鑰不屬於本程式碼研究室的一部分。如要進一步瞭解 SHA-1 金鑰，請參閱這份文件。

按一下 [Register App] (註冊應用程式) 按鈕。

下載設定檔

按一下「下載 google-services.json」按鈕，下載設定檔 google-services.json。

在 Android Studio 中，前往 app 目錄，並將您剛才下載的 google-services.json 檔案移至 app 目錄。返回 Firebase 控制台，然後點選「下一步」按鈕。

在應用程式中啟用 Firebase

您需要 Google 服務 Gradle 外掛程式，才能讀取 Firebase 產生的 google-services.json 檔案。
在 Android Studio 中開啟 <project>/build.gradle，然後在檔案中加入下列幾行內容：

buildscript { 
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
   }
   dependencies {
      ...
      // Add this line
      classpath 'com.google.gms:google-services:4.3.4'
   }
}

allprojects {
   ...
   repositories {
      // Check that you have the following line (if not, add it):
      google() //Google's Maven repository
      ...
      }
   }
}

開啟 <project>/<app-module>/build.gradle，然後在檔案中加入下列幾行內容：

apply plugin: 'com.android.application'
// Add this line
apply plugin: 'com.google.gms.google-services'

您現已完成將 Firebase 新增至 Android 應用程式的程序！

在下一個步驟中，您將瞭解如何將 Firebase SDK 加入應用程式。

4. 在應用程式中加入 Firebase SDK

在這個步驟中，您將新增 Firebase SDK，特別是 Google Analytics 專用 Firebase SDK。

我們將使用 Firebase Android BoM，讓您指定 BoM 版本，藉此管理應用程式中使用的 Firebase 程式庫版本。如要瞭解哪些 Firebase 程式庫版本會對應至特定的 BoM 版本，請參閱該 BoM 版本的版本資訊。

開啟 <project>/<app-module>/build.gradle，然後在檔案中加入下列幾行內容：

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx'

如您所見，只要指定 BoM 版本，就不必指定 Firebase Analytics 程式庫的版本。但無論您在 BoM 中指定的版本為何，如果您想使用所需的 Firebase 程式庫版本，只要按照以下方式指定所需版本即可：

dependencies { 
   // ... 
   
   //Import the Firebase BoM
   implementation platform('com.google.firebase:firebase-bom:26.1.1')
   
   //Declare the dependency for the Firebase SDK for Google Analytics
   implementation 'com.google.firebase:firebase-analytics-ktx:17.0.0'

現在，請按一下「Sync Now」按鈕，同步處理應用程式。

您已完成將 Google Analytics 專用 Firebase SDK 加入 Android 應用程式的程序！

下一個步驟將說明如何在 Android 應用程式中記錄 Firebase 事件。

5. 使用 Firebase 數據分析記錄事件

在這個步驟中，您將瞭解如何在 Android 應用程式中使用 Firebase Analytics 記錄事件。

記錄事件的方式有 2 種：使用建議事件或自訂事件。

使用建議事件

Firebase Analytics SDK 定義了多種建議事件，可用於遊戲、零售、旅遊和電子商務等各種應用程式。此外，還有部分建議事件需要使用規定的參數。搭配這些參數，您就能在 Firebase 報表中納入更多可用詳細資料。( 建議事件參考資料)。

在活動最上方宣告 FirebaseAnalytics 物件：

private lateinit var firebaseAnalytics: FirebaseAnalytics

將 onCreate() 方法中的物件初始化：

firebaseAnalytics = Firebase.analytics

使用 logEvent() 方法開始記錄事件。以下程式碼會在使用者在應用程式中購買商品時記錄 PURCHASE 事件：

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.PURCHASE) {
   param(FirebaseAnalytics.Param.VALUE, 10)
   param(FirebaseAnalytics.Param.CURRENCY, "USE")
}

使用自訂事件

如果您需要建議事件未涵蓋的事件，可以使用自訂參數自行記錄自訂事件：

firebaseAnalytics.logEvent("delete_item"){
   param("item name", name)
   param("reason", text)
}

偵錯事件

您可以在 Firebase 控制台中查看事件的相關匯總資料和報表。但更新內容會在一天中定時生效，您無法在登入應用程式後立即查看這些事件。

如要立即測試及偵錯，可以使用 Firebase Debugview。DebugView 可讓您以近乎即時的方式，在開發裝置上查看應用程式記錄的事件資料。如果是 DebugView，請參閱「偵錯事件」一節。

您已經完成在 Android 應用程式中記錄事件了！

在下一個步驟中，您將瞭解如何將這些事件匯入 Google Ads。

6. 將 Firebase 事件匯入 Google Ads

Firebase 與 Android 設定程序已完成，你可以開始推出已記錄動作事件的應用程式廣告活動。請先將 Firebase 連結至 Google Ads，將 Firebase 連結至 Google Ads 後，應用程式廣告活動就能進一步瞭解目標對象，並提升應用程式廣告活動學習成效，通常有助於提升成效與轉換率。

連結 Firebase 與 Google Ads

點選「專案總覽」旁邊的按鈕，前往 Firebase 設定。

「整合」分頁中會顯示「Google Ads」和「連結」按鈕。按一下「連結並繼續」。

選擇要連結的 Google Ads 帳戶。

您現已完成 Firebase 與 Google Ads 連結程序。現在就將 Firebase 事件匯入 Google Ads。

匯入 Firebase 事件

在 Firebase 控制台中，前往「事件」選單，將您要匯入的事件標示為轉換。

現在，請前往 Google Ads 登入與 Firebase 連結的帳戶。
在 Google Ads 中，前往「工具」→「評估」→「轉換」
按一下 + 按鈕
選擇「應用程式」→「Google Analytics 4 資源 (Firebase)」，然後按一下「繼續」。
您可以查看所有標示為轉換的 Analytics 事件。找出要匯入的事件。在本例中，請選擇先前導入的 delete_item 事件。按一下 [匯入並繼續] 按鈕。
您已成功從 Firebase 匯入轉換事件。