為行動應用程式導入 Google Analytics (分析) 功能

搭配 Google Analytics (分析) 和 Firebase 使用代碼管理工具。

您在自己的 Android 和 iOS 應用程式中導入 Firebase 後，就能使用 Google Analytics (分析) 最新的行動應用程式報表功能。在應用程式內啟用 Firebase，Google Analytics (分析) 就會自動收集並記錄內建的事件與使用者屬性。您還可以記錄自訂事件及設定自訂使用者屬性。

行動應用程式專用的代碼管理工具可透過 Firebase SDK 導入，並且需要您建立一個代碼管理工具容器。此外，您可以在代碼管理工具內設定所有的 Google Analytics 事件、參數和使用者屬性。

搭配使用代碼管理工具、Firebase 和 Google Analytics (分析)

使用 Firebase 的應用程式會自動將資料記錄在 Google Analytics (分析) 內；Firebase SDK 中的 Google Analytics for Firebase 服務會自動為您收集應用程式使用情況資料，而報表會顯示在 Google Analytics (分析) 和 Firebase 主控台中。使用 Firebase SDK 後，您不需要另外加入程式碼，就能讓系統自動收集事件。

如果已啟用 Firebase 的應用程式需要設定額外的 Google 和第三方代碼，請為應用程式導入代碼管理工具。

在行動裝置專案中導入代碼管理工具的做法如下：

在您的應用程式中設定 Firebase：
- 安裝 Firebase SDK (Android 版說明 | iOS 版說明)。
- 在 Firebase 主控台內，將您的應用程式新增至 Firebase 專案中。
- 將 Firebase Analytics 加進應用程式 (Android 版說明 | iOS 版說明)。
建立代碼管理工具帳戶，然後設定代碼管理工具容器。
將代碼管理工具加進專案 (Android 版說明 | iOS 版說明)。

請使用「事件名稱」和「事件參數」變數來設定觸發條件，藉此指定用來啟動特定代碼的事件；這樣一來，每次應用程式記錄到事件，系統就會評估觸發條件。如想進一步瞭解相關詳情，請參閱代碼管理工具開發人員說明文件 (Android 版或 iOS 版)。

自動收集的事件由 Firebase SDK 產生，並由 Google Analytics (分析) 收集，您無法修改這類事件。

建立 Google Analytics (分析) (Firebase) 代碼

建立 Google Analytics (分析) (Firebase) 代碼的方式如下：

為 Android 或 iOS 應用程式建立 Google Analytics for Firebase 容器。
依序點選 [代碼] [新增]。
按一下 [代碼設定]，然後選取 [Google Analytics (分析) (Firebase)]。
使用 [動作] 選單來修改、新增或封鎖事件。
- 封鎖事件：這個選項可用來封鎖手動記錄的事件 (例如開發人員不小心重複記錄事件，亦或是記錄到不需要記下的事件/太多不重複事件的名稱)，這些事件的資料就不會傳送給 Firebase Analytics。
- 新增事件：如果您想要同時評估兩個事件，請使用這個選項。
  - 在「覆寫事件名稱」欄位中編輯參數名稱。
  - 使用「要新增/編輯的參數」來新增鍵名和值，方法是按一下 [新增列] 按鈕，然後輸入正確的鍵名和值。
  - 使用「要剔除的參數」來指定該在代碼啟動時剔除的鍵名。
- 修改事件：這個選項可用來確保各版本應用程式的參數名稱一致。舉例來說，您為 Android 版應用程式將某事件命名為「save_image」，但 iOS 版應用程式中同一個事件的名稱卻是「save_new_image」。
  - 在「覆寫事件名稱」欄位中編輯參數名稱。
  - 使用「要新增/編輯的參數」來新增鍵名和值，方法是按一下 [新增列] 按鈕，然後輸入正確的鍵名和值。
  - 使用「要剔除的參數」來指定該在代碼啟動時剔除的鍵名。
- 按一下 [觸發條件] ，然後指定合適的事件觸發條件來啟動這個代碼。
儲存並發佈代碼設定。

透過代碼管理工具在 Firebase 專案中啟用通用 Analytics (分析)

只要使用 Firebase，您就可以為應用程式啟用代碼管理工具容器，然後使用代碼管理工具輕鬆設定與部署通用 Analytics (分析) 代碼，或 Google 支援的任何第三方代碼。

如要透過代碼管理工具設定通用 Analytics (分析) 代碼，請按照下列步驟進行：

在您的應用程式中設定 Firebase：
1. 安裝 Firebase SDK (Android 版說明 | iOS 版說明)。
2. 在 Firebase 主控台內，將您的應用程式新增至 Firebase 專案中。
3. 將 Firebase Analytics 加進應用程式 (Android 版說明 | iOS 版說明)。
建立代碼管理工具帳戶，然後設定代碼管理工具容器。
將代碼管理工具加進專案 (Android 版說明 | iOS 版說明)。
在代碼管理工具中建立 Google Analytics (分析) 代碼。

我們已經淘汰了 InstallBroadcast API，因此通用 Analytics (分析) 再也無法對應用程式新使用者進行歸因分析。為因應這項異動，建議您改用新一代 Google Analytics (分析) 4。

應用程式經過 Firebase 和代碼管理工具編譯後，您就可以透過代碼管理工具介面新增其他任何代碼，無須重新建構應用程式。

系統會自動為 Firebase SDK 啟用 IP 去識別化功能，您不需要透過 Google Analytics (分析) 的設定變數進行設定。

代碼管理工具中 Android 和 iOS 應用程式適用的自動收集事件

請查看下表，瞭解代碼管理工具中有哪些 Android 和 iOS 應用程式適用的 Google Analytics for Firebase 自動收集事件：

事件	Android 裝置	iOS 裝置
app_exception	✓
app_update		✓
firebase_campaign	✓	✓
first_open		✓
in_app_purchase		✓
notification_dismiss	✓
notification_foreground	✓	✓
notification_open	✓	✓
notification_receive	✓
os_update	✓	✓
session_start	✓	✓
user_engagement	✓	✓

修改及封鎖事件

代碼管理工具可讓您運用 Google Analytics (分析) (Firebase) 代碼來修改、新增或封鎖自訂事件 (就算應用程式已經發布，還是可以進行這些調整)。根據預設，就算您使用代碼管理工具，您在應用程式中利用 Firebase SDK 記錄到的事件仍然都會傳送至 Google Analytics (分析)；要是您在新舊版應用程式中為同一個事件設定了不同名稱，這個功能就能派上用場，確保您向舊版應用程式使用者收集到的資料與新版的一致。

重要注意事項：請只在需要修改、新增或封鎖由 Firebase 記錄的「自訂」事件時，才使用 Google Analytics (分析) (Firebase) 代碼。此外，您無法修改系統自動收集的事件。

這對您有幫助嗎？

我們應如何改進呢？