詳解Google Analytics 4 事件追蹤——自動收集的事件

文章目錄

更新時間：2024年10月9號

認識自動收集的事件

自動收集的事件就是，只要你安裝有的是 Google Analytics for Firebase SDK 或 gtag.js，使用者與你的應用程式和/或網站進行基本互動時，不必另外撰寫程式碼就會觸發系統自動收集的事件。

自動收集的事件分類

網站

事件	自動觸發時機…	參數
first_visit	使用者初次啟用安裝有GA4的網站/應用程式時
page_view	每次網頁載入或有效網站變更了瀏覽記錄狀態時觸發	page_location (網頁網址)、page_referrer (前一個網頁網址)、engagement_time_msec
session_start	在有使用者與應用程式/網站互動時觸發系統會自動針對每個工作階段產生工作階段 ID 和工作階段編號，並與工作階段中的每個事件建立關聯。
user_engagement	應用程式於前景運作或網頁成為焦點至少一秒時。	engagement_time_msec

需要注意：並不是所有的工作階段都會有session_start，延伸閱讀：認識 Google Analytics 4 的工作階段（Sessions）

應用程式

應用程式的自動收集的事件：

事件	自動觸發時機…	參數
ad_click	使用者點按廣告時觸發，這個是從AdMob 獲取	ad_event_id
ad_exposure	畫面上至少有一則由 Mobile Ads SDK 放送的廣告時這個事件不會顯示在報表中，也不會匯出至 BigQuery。	firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time
ad_impression	廣告曝光時觸發，這個是從AdMob 獲取	ad_event_id、value
ad_query	Mobile Ads SDK 送出廣告請求時這個事件不會顯示在報表中，也不會匯出至 BigQuery。	ad_event_id
ad_reward	Mobile Ads SDK 放送的獎勵廣告給予獎勵時	ad_unit_code、reward_type、reward_value
adunit_exposure	畫面上有一個廣告單元是由 Mobile Ads SDK 放送時這個事件不會顯示在報表中，也不會匯出至 BigQuery。	firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time
app_clear_data	使用者重設/清除應用程式資料來移除所有設定和登入資料時僅限 Android 裝置
app_exception	應用程式當機或擲回例外狀況時	fatal、timestamp、engagement_time_msec
app_remove	從 Android 裝置移除 (解除安裝) 應用程式套件時僅限 Android 裝置  這個事件與「每日解除安裝的裝置數」和「每日解除安裝應用程式的使用者人數」指標不同，後兩者皆由 Google Play 管理中心記錄。「app_remove」事件計算應用程式套件的移除次數，並不會考量安裝來源，而且計數會隨著您為報表設定的日期範圍而變動。「每日解除安裝的裝置數」和「每日解除安裝應用程式的使用者人數」指標則只計算透過 Google Play 安裝的應用程式套件的移除次數，而且系統會每天回報這兩項數據。
app_store_refund	Google Play 退還應用程式內購的款項時僅限 Android 裝置這個事件不會匯出至 BigQuery。	product_id、value、currency、quantity
app_store_ subscription_cancel	在 Google Play 取消付費訂閱時僅限 Android 裝置首次訂閱時間必須是在 2019 年 7 月 1 日當天或之後。這個事件不會匯出至 BigQuery。	product_id、price、value、currency、cancellation_reason
app_store_ subscription_convert	使用者從免費試用訂閱轉換成付費訂閱時此為預設的轉換事件。首次訂閱時間必須是在 2019 年 7 月 1 日當天或之後。系統會將一開始的免費試用訂閱記錄為 in_app_purchase，訂閱參數則設為 true。這個事件不會匯出至 BigQuery。	product_id、price、value、currency、quantity
app_store_ subscription_renew	使用者付費續訂時此為預設的轉換事件。首次訂閱時間必須是在 2019 年 7 月 1 日當天或之後。這個事件不會匯出至 BigQuery。	product_id、price、value、currency、quantity、renewal_count
app_update	應用程式更新為新版本並再次啟動時 (舊版應用程式的版本 ID 會以參數的形式傳送)。這個事件的概念與「每日升級應用程式的裝置數」指標不同 (後者由 Google Play 管理中心記錄)：升級是指更新應用程式二進位檔，app_update 事件則是在後續啟動已升級的應用程式時觸發。	previous_app_version
dynamic_link_app_open	使用者透過動態連結再次開啟應用程式時	source、medium、campaign、link_id、accept_time
dynamic_link_ app_update	使用者將應用程式更新為新版本，並透過動態連結開啟時僅限 Android 裝置	source、medium、campaign、link_id、accept_time
dynamic_link_ first_open	使用者透過動態連結初次開啟應用程式時	source、medium、campaign、link_id、accept_time
錯誤	當事件因某些因素失效而無法記錄時，系統會改為記錄此事件  _err (firebase_error)、_ev (firebase_error_value) 和 _el (firebase_error_length) 參數內含額外資訊。這個事件不會顯示在報表中，也不會匯出至 BigQuery。	firebase_error、firebase_error_value
firebase_campaign	當廣告活動參數啟動了應用程式時這個事件不會顯示在報表中，也不會匯出至 BigQuery。	source、medium、campaign、term、content、gclid、aclid、cp1、anid、click_timestamp、campaign_info_source
firebase_in_app_ message_action	使用者對 Firebase 傳送的應用程式內訊息採取行動時	message_name、message_device_time、message_id
firebase_in_app_ message_dismiss	使用者關閉 Firebase 傳送的應用程式內訊息時	message_name、message_device_time、message_id
firebase_in_app_ message_impression	使用者查看 Firebase 傳送的應用程式內訊息時	message_name、message_device_time、message_id
first_open	使用者安裝/重新安裝某個應用程式後，初次開啟該應用程式時使用者初次使用應用程式時才會觸發這個事件，將應用程式下載到裝置上並不會觸發。您可以到 Google Play 管理中心或 iTunes Connect 查看原始下載次數。支援對已接受 Apple iOS 14 應用程式追蹤提示的使用者，評估其完成的 first_open 轉換。	previous_gmp_app_id、updated_with_analytics、previous_first_open_count、system_app、system_app_update、deferred_analytics_collection、reset_analytics_cause、engagement_time_msec
first_visit	使用者初次啟用安裝有GA4的網站/應用程式時
in_app_purchase	使用者完成應用程式內購 (包含初次訂閱)，而且該次購買是由 iTunes App Store 或 Google Play 處理時，就會觸發這個事件產品 ID、產品名稱、幣別和購買數量均會以參數的形式傳送。  您必須將 Analytics (分析) 連結至 Google Play，才能查看 Android 應用程式的 in_app_purchase 資料。 Analytics (分析) 可在 Android 和 iOS 裝置上自動追蹤訂閱。  只有包含 Google Analytics for Firebase SDK 的應用程式版本才會觸發這個事件。請注意，系統不會自動追蹤付費應用程式的購買收益和退款 (僅限 iOS)，因此報表列的收益可能與 Google Play 管理中心記錄的金額不同。此外，系統也會忽略標為無效或沙箱 (測試) 的事件 (只有 iOS 事件才會標為沙箱)。測試 Google Play 帳款服務的做法請見這篇文章。	product_id、price、value、currency、quantity、subscription、free_trial、introductory_price
notification_dismiss	使用者關閉 Firebase 雲端通訊 (FCM) 傳送的通知時僅限 Android 裝置	message_name、message_time、message_device_time、message_id、topic、label、message_channel
notification_foreground	在應用程式於前景運作期間收到 FCM 傳送的通知時	message_name、message_time、message_device_time、message_id、topic、label、message_channel、message_type
notification_open	使用者開啟 FCM 傳送的通知時	message_name、message_time、message_device_time、message_id、topic、label、message_channel
notification_receive	裝置在應用程式於背景運作期間收到 FCM 傳送的通知時僅限 Android 裝置	message_name、message_time、message_device_time、message_id、topic、label、message_channel、message_type
notification_send	當 FCM 傳送通知時僅限 Android 裝置	message_name、message_time、message_device_time、message_id、topic、label、message_channel
os_update	裝置的作業系統更新為新版本時 (舊版作業系統的版本 ID 會以參數的形式傳送)	previous_os_version
screen_view	使用者切換畫面且滿足下列任一條件時，就會觸發這個事件：先前未設定任何畫面新畫面名稱與前一個畫面的名稱不同新畫面類別名稱與前一個畫面的類別名稱不同新畫面 ID 與前一個畫面 ID 不同	firebase_screen、firebase_screen_class、firebase_screen_id、firebase_previous_screen、firebase_previous_class、firebase_previous_id、engagement_time_msec
session_start	在有使用者與應用程式/網站互動時觸發系統會自動針對每個工作階段產生工作階段 ID 和工作階段編號，並與工作階段中的每個事件建立關聯。
user_engagement	應用程式於前景運作或網頁成為焦點至少一秒時。	engagement_time_msec

不同的自动收集事件对应有不同的事件参数，但其实，所有的自动收集事件都会有一些预设事件参数，所有的事件都有，不仅仅是自动收集的事件。

预设事件参数

所有的事件都会有如下预设事件参数：

language
page_location（1000）
page_referrer（420）
page_title（300）
screen_resolution

事件參數的值不得超過 100 個半形字元，page_referrer不得超過420個半形字元 ， page_location不得超過1000個半形字元， page_title 不得超過 300 個半形字元。

官方建議不要覆蓋修改page_location，因為網址路徑無效會導致參數為空，如果你的page_location的资料为空，那么检查網址路徑是否為空。

自動收集的事件中添加自訂參數

自動收集的事件裡添加自訂參數的做法就是將原有的事件停止，另外發送一個事件。

比如page_view的默認事件參數是page_location (網頁網址)、page_referrer (前一個網頁網址)、engagement_time_msec

我現在想添加自定義參數page_name，那麼將原有的page_view停止，然後發送新page_view。

新的page_view的事件參數是page_location (網頁網址)、page_referrer (前一個網頁網址)、engagement_time_msec、page_name

如果您在操作上仍有任何疑問，歡迎留言交流，或加入：Google Analytics 4交流社團發問

認識自動收集的事件

自動收集的事件分類

網站

應用程式

预设事件参数

自動收集的事件中添加自訂參數

Hi，*为發佈留言必須填寫。