使用者與您的應用程式和/或網站進行基本互動時，就會觸發系統自動收集的事件 (如下表中事件名稱下方所示)。只要您使用的是 Google 代碼或 Google Analytics for Firebase SDK，不必另外撰寫程式碼即可收集這些事件。
除非另有註明，否則 Analytics 會為 Android 和 iOS 應用程式收集這些事件。在 BigQuery 中存取原始事件資料時，可以使用這些事件的名稱和參數。
如要瞭解下列各個事件參數以及每個參數如何更新 Google Analytics 中的維度或指標，請參閱「Google Analytics 事件參數」一文。
注意：
以下是每個事件 (包括自訂事件) 預設會收集的幾個參數：
- 網站串流：
- 語言
- page_location
- page_referrer
- page_title
- screen_resolution
- 應用程式串流：
- app_version
- firebase_screen_id
- firebase_screen_class
指派給事件參數的值不得超過 100 個半形字元；「page_title」page_title參數不得超過 300 個半形字元；「page_referrer」page_referrer參數不得超過 420 個半形字元。「page_location」page_location參數不得超過 1,000 個半形字元。
如要覆寫「page_location」page_location參數，請確認網址路徑有效。如果指派的網址路徑無效，「網頁位置」維度會是空白。您可以使用廣告活動網址產生器檢查網址路徑是否有效。
除非您停用畫面瀏覽追蹤，否則系統會自動收集「firebase_screen_id」和「firebase_screen_class」參數。
| 活動 | 自動觸發時機… | 參數 |
|---|---|---|
|
ad_click (應用程式) |
使用者點按廣告時 發布商事件源自於 AdMob (透過 Google Mobile Ads SDK) 或 Ad Manager (透過 Ad Manager 整合) 這個事件不會匯出至 BigQuery。 |
ad_event_id |
|
ad_exposure (應用程式) |
畫面上至少有一則由 Mobile Ads SDK 放送的廣告時 這個事件不會顯示在報表中，也不會匯出至 BigQuery。 |
firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time |
|
ad_impression (應用程式) |
使用者看到一次廣告曝光時 發布商事件源自於 AdMob (透過 Google Mobile Ads SDK) 或 Ad Manager (透過 Ad Manager 整合) 這個事件不會匯出至 BigQuery。 注意：使用預設整合時，系統不會傳遞 |
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 (應用程式) |
應用程式當機或擲回例外狀況時 您整合 Firebase Crashlytics 後，系統就會傳送這個事件。 |
fatal、timestamp、engagement_time_msec |
|
app_remove (應用程式) |
從 Android 裝置移除 (解除安裝) 應用程式套件時 僅限 Android 裝置 |
|
|
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 |
|
點擊 (網站) |
每次使用者點按的連結會帶離目前網域時 根據預設，凡是將使用者從目前網域帶離的連結，都會觸發外連點擊事件。若為針對跨網域評估所設定的網域連結，則不會觸發外連點擊事件。 參數會填入下列維度：
預設為透過加強型評估收集。 |
link_classes、link_domain、link_id、link_url、outbound (布林值) |
|
dynamic_link_app_open (應用程式) |
使用者透過動態連結再次開啟應用程式時 注意：Firebase Dynamic Links 目前已淘汰，因此這個事件正逐步停用。進一步瞭解這些異動。 |
source、medium、campaign、link_id、accept_time |
|
dynamic_link_ app_update (應用程式) |
使用者將應用程式更新為新版本，並透過動態連結開啟時 僅限 Android 裝置 注意：Firebase Dynamic Links 目前已淘汰，因此這個事件正逐步停用。進一步瞭解這些異動。 |
source、medium、campaign、link_id、accept_time |
|
dynamic_link_ first_open (應用程式) |
使用者透過動態連結初次開啟應用程式時 注意：Firebase Dynamic Links 目前已淘汰，因此這個事件正逐步停用。進一步瞭解這些異動。 |
source、medium、campaign、link_id、accept_time |
|
錯誤 (應用程式) |
當事件因某些因素失效而無法記錄時，系統會改為記錄此事件 這個事件不會顯示在報表中，也不會匯出至 BigQuery。 |
firebase_error、firebase_error_value |
|
file_download (網站) |
當使用者點按的連結會連往下列類型檔案 (包含常見副檔名) 時：
此事件預設為透過加強型評估收集。查看觸發事件的副檔名 |
file_extension、file_name link_classes、link_id、link_text、link_url |
|
firebase_campaign (應用程式) |
當廣告活動參數啟動了應用程式時 |
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 (應用程式、網站) |
使用者初次瀏覽啟用了 Analytics 的網站，或第一次使用啟用了 Analytics 的 Android 免安裝應用程式時 | client_id、ga_session_id、ga_session_number、ignore_referrer、page_location、page_referrer、page_title、traffic_type |
|
form_start (網站) |
使用者第一次在工作階段中與表單互動時 預設為透過加強型評估收集。 |
form_id、form_name、form_destination |
|
form_submit (網站) |
使用者提交表單時 預設為透過加強型評估收集。 |
form_id、form_name、form_destination、form_submit_text |
|
in_app_purchase (應用程式) |
使用者完成應用程式內購 (包含初次訂閱)，而且該次購買是由 Apple App Store 或 Google Play 商店處理時，就會觸發這個事件 產品 ID、產品名稱、幣別和購買數量均會以參數的形式傳送。 只有包含 Google Analytics for Firebase SDK 的應用程式版本才會觸發這個事件。 Android： 如要查看 Android 應用程式的應用程式內購資料，請將 Analytics 連結至 Google Play。 請注意，Analytics 不會自動評估付費應用程式的購買收益。 此外，Google Analytics 記錄的收益可能會與 Google Play 管理中心記錄的金額有出入。 Analytics 會忽略標記為無效或測試的事件。請見這篇文章，進一步瞭解如何測試 Google Play 帳款服務。 iOS： 請注意，Analytics 不會自動評估付費應用程式的購買收益和退款。 Analytics 會忽略標記為無效或沙箱的事件。 |
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 |
|
os_update (應用程式) |
裝置的作業系統更新為新版本時 (舊版作業系統的版本 ID 會以參數的形式傳送) | previous_os_version |
|
page_view (網站) |
每次網頁載入或有效網站變更了瀏覽記錄狀態時 預設為透過加強型評估收集。 |
page_location (網頁網址)、page_referrer (前一個網頁網址)、engagement_time_msec |
|
screen_view (應用程式) |
使用者切換畫面且滿足下列任一條件時，就會觸發這個事件：
|
firebase_screen、firebase_screen_class、firebase_screen_id、firebase_previous_screen、firebase_previous_class、firebase_previous_id、engagement_time_msec |
|
scroll (網站) |
使用者在各個網頁上第一次瀏覽到網頁底部時 (意即可見的網頁垂直捲動深度達 90%) 預設為透過加強型評估收集。 |
engagement_time_msec |
|
session_start (應用程式、網站) |
在有使用者與應用程式/網站互動時觸發 系統會自動針對每個工作階段產生工作階段 ID 和工作階段編號，並與工作階段中的每個事件建立關聯。瞭解詳情 |
client_id、ga_session_id、ga_session_number、ignore_referrer、page_location、page_referrer、page_title、traffic_type |
|
user_engagement (應用程式、網站) |
應用程式於前景運作或網頁成為焦點至少一秒時。瞭解詳情 |
engagement_time_msec |
|
video_complete (網站) |
影片播放結束時 針對已啟用 JS API 支援功能的內嵌 YouTube 影片。 預設為透過加強型評估收集。 |
video_current_time、video_duration、video_percent、video_provider、video_title、video_url、visible (boolean) |
|
video_progress (網站) |
影片播放進度超過時間長度的 10%、25%、50% 及 75% 時 針對已啟用 JS API 支援功能的內嵌 YouTube 影片。 預設為透過加強型評估收集。 |
video_current_time、video_duration、video_percent、video_provider、video_title、video_url、visible (boolean) |
|
video_start (網站) |
影片開始播放時 針對已啟用 JS API 支援功能的內嵌 YouTube 影片。 預設為透過加強型評估收集。 |
video_current_time、video_duration、video_percent、video_provider、video_title、video_url、visible (boolean) |
|
view_search_results (網站) |
每次使用者進行站內搜尋時 (會出現網址查詢參數) 預設為透過加強型評估收集。 |
search_term、視需要選用的 q_<additional key=""> (<additional key=""> 與透過進階設定指定收集的額外查詢參數相符) 注意：這個事件只會傳送值為 1 (亦即字串專屬於該工作階段) 的 unique_search_term 參數。 |
注意：與下列規則運算式相符的副檔名會觸發 file_download 事件：
pdf|xlsx?|docx?|txt|rtf|csv|exe|key|pp(s|t|tx)|7z|pkg|rar|gz|zip|avi|mov|mp4|mpe?g|wmv|midi?|mp3|wav|wma