文章目錄
認識自動收集的事件
自動收集的事件就是，只要你安裝有的是 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 | 使用者切換畫面且滿足下列任一條件時，就會觸發這個事件：
|
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
- page_referrer
- page_title
- 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交流社團發問
