[GA4] 自動收集的事件

使用者與您的應用程式和/或網站進行基本互動時,就會觸發系統自動收集的事件 (如下表中事件名稱下方所示)。只要您使用的是 Google Analytics for Firebase SDKgtag.js,不必另外撰寫程式碼即可收集這些事件。

除非另有註明,否則 Analytics (分析) 會為 Android 和 iOS 應用程式收集這些事件。BigQuery 中存取原始事件資料時,可以使用這些事件的名稱和參數。

如要瞭解下列各個事件參數以及每個參數如何更新 Google Analytics (分析) 中的維度或指標,請參閱「Google Analytics (分析) 事件參數」一文。

注意事項

根據預設,每個事件都會收集以下參數,包括自訂事件

  • language
  • page_location
  • page_referrer
  • page_title
  • screen_resolution

指派給事件參數的值不得超過 100 個半形字元;「page_title」參數不得超過 300 個半形字元;「page_referrer」參數不得超過 420 個半形字元。「page_location」參數不得超過 1,000 個半形字元。

如要覆寫「page_location」參數,請確認網址路徑有效。如果指派的網址路徑無效,「網頁位置」維度會是空白。您可以使用廣告活動網址產生器檢查網址路徑是否有效。

事件 自動觸發時機… 參數

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 裝置

這個事件與「每日解除安裝的裝置數」和「每日解除安裝應用程式的使用人數」指標不同,後兩者皆由 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

click

(網站)

每次使用者點按的連結會帶離目前網域時

根據預設,凡是將使用者從目前網域帶離的連結,都會觸發外連點擊事件。若為針對跨網域評估所設定的網域連結,則不會觸發外連點擊事件。

參數會填入下列維度:

預設為透過加強型評估收集。

link_classes、link_domain、link_id、link_url、outbound (布林值)

使用者透過動態連結再次開啟應用程式時

注意:Firebase Dynamic Links 目前已淘汰,因此這個事件正逐步停用。進一步瞭解這些異動

source、medium、campaign、link_id、accept_time

使用者將應用程式更新為新版本,並透過動態連結開啟時

僅限 Android 裝置

注意:Firebase Dynamic Links 目前已淘汰,因此這個事件正逐步停用。進一步瞭解這些異動

source、medium、campaign、link_id、accept_time

使用者透過動態連結初次開啟應用程式時

注意:Firebase Dynamic Links 目前已淘汰,因此這個事件正逐步停用。進一步瞭解這些異動

source、medium、campaign、link_id、accept_time

錯誤

(應用程式)

當事件因某些因素失效而無法記錄時,系統會改為記錄此事件

_err (firebase_error)、_ev (firebase_error_value) 和 _el (firebase_error_length) 參數內含額外資訊。

這個事件不會顯示在報表中,也不會匯出至 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 免安裝應用程式時  

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

(應用程式)

使用者切換畫面且滿足下列任一條件時,就會觸發這個事件:
  • 先前未設定任何畫面
  • 新畫面名稱與前一個畫面的名稱不同
  • 新畫面類別名稱與前一個畫面的類別名稱不同
  • 新畫面 ID 與前一個畫面 ID 不同
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 和工作階段編號,並與工作階段中的每個事件建立關聯。瞭解詳情

 

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

* 系統會使用預設整合來傳遞 no_ad_impression 值或貨幣

這對您有幫助嗎?

我們應如何改進呢?
true
搜尋
清除搜尋內容
關閉搜尋
Google 應用程式
主選單