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

Google Ads 與 Google Analytics for Firebase 自訂活動 - Android

一、簡介

最後更新： 2020-12-14

你將建構什麼

在此 Codelab 中，您將學習如何使用 Google Analytics for Firebase (GA4F) 實施事件並透過 Google Ads 發起行動行銷活動。

此 Codelab 重點介紹使用 GA4F 實施事件並將事件匯入 Google Ads。如果您想了解如何使用 Firebase 建立 Android 應用，請參閱Firebase Android Codelab-建置友善聊天。

你將學到什麼

如何建立 Firebase 項目
如何在Android應用程式中實作Firebase SDK
如何建立事件和參數。
如何將活動從 Firebase 匯入到 Google Ads
透過自訂事件啟動 Google Ads 行動廣告活動。

你需要什麼

Android Studio 3.6 或更高版本
Firebase 帳戶
Google廣告帳戶

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 中進入 app 目錄，開啟檔案名稱build.gradle 。在文件中，搜尋applicationId 。該值是 Android 套件名稱。複製該值並貼上。

我們這裡不需要 SHA-1 金鑰，除非您打算使用Google Sign In或Firebase Dynamic Links （請注意，這些不是本 Codelab 的一部分，有關 SHA-1 金鑰的更多信息，請參閱此文件。）。

點擊註冊應用程式按鈕。

下載設定檔

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

在 Android Studio 中，前往app目錄並將google-services.json檔案（您剛剛在上面下載）移至app目錄中。返回 Firebase 控制台，按一下「下一步」按鈕。

在您的應用程式中啟用 Firebase

您需要Google Services 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 分析庫的版本。但是，如果您想要為 Firebase 程式庫使用所需的版本，無論 BoM 中指定了哪個版本，您只需指定所需的版本，如下所示：

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 Analytics 記錄事件

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

記錄事件有兩種方法：使用建議事件或自訂事件。

使用建議的事件

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 關聯，應用程式廣告系列將能夠更多地了解受眾群體並促進應用程式廣告系列的學習，這通常會帶來更好的效果和轉換。