自動收集的事件

下方列出的事件在測試階段可能會變動。

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

除非另有註明,否則 Analytics (分析) 會為 Android 和 iOS 應用程式收集這些事件。

需要管理事件時 (例如標示為轉換、新增參數等),請按一下左側窗格中的 [事件] > [所有事件]。

Analytics (分析) 報表就會顯示事件資料。

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

  • language
  • page_location
  • page_referrer
  • page_title
  • screen_resolution
事件名稱 自動觸發時機 參數

ad_click

(應用程式)

使用者點擊廣告時

發布商事件源自於 AdMob (透過 Google Mobile Ads SDK)

ad_event_id

ad_exposure

(應用程式)

畫面上有至少一則由 Mobile Ads SDK 放送的廣告時 firebase_screen、firebase_screen_id、firebase_screen_class、exposure_time

ad_impression

(應用程式)

使用者看到一次廣告曝光時

發布商事件源自於 AdMob (透過 Google Mobile Ads SDK)

ad_event_id

ad_query

(應用程式)

Mobile Ads SDK 送出廣告請求時 ad_event_id

ad_reward

(應用程式)

Mobile Ads SDK 放送的獎勵廣告給予獎勵時 ad_unit_id、reward_type、reward_value

adunit_exposure

(應用程式)

畫面上有一個廣告單元是由 Mobile Ads SDK 放送時 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

click

(網站)

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

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

系統不會收集任何參數
使用者透過動態連結再次開啟應用程式時 source、medium、campaign、link_id、accept_time

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

僅限 Android 裝置

source、medium、campaign、link_id、accept_time
使用者透過動態連結初次開啟應用程式時 source、medium、campaign、link_id、accept_time

錯誤

(應用程式)

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

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

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

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

file_extension、file_name link_classes、link_domain、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 轉換。
previoius_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 免安裝應用程式時  

in_app_purchase

(應用程式)

使用者完成應用程式內購 (包含初次訂閱),而且該次購買是由 iTunes App Store 或 Google Play 處理時,就會觸發這個事件

產品 ID、產品名稱、幣別和購買數量均會以參數的形式傳送。

您必須將 Analytics (分析) 連結至 Google Play,才能查看 Android 應用程式的 in_app_purchase 資料。

Analytics (分析) 可在 Android 裝置上自動追蹤訂閱,近期也將為 iOS 裝置推出相同功能。

只有包含 Firebase SDK 的應用程式版本才會觸發這個事件。請注意,系統不會自動追蹤付費應用程式的購買收益和退款 (僅限 iOS),因此報表列的收益可能與 Google Play 管理中心記錄的金額不同。此外,系統也會忽略標為無效或沙箱 (測試) 的事件 (只有 iOS 事件才會標為沙箱)。測試 Google Play 帳款服務的做法請見這篇文章

product_id、price、value、currency、quantity、subscription、free_trial、introductory_price

notification_dismiss

(應用程式)

使用者關閉 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

page_view

(網站)

每次網頁載入或有效網站變更了瀏覽記錄狀態時

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

page_location (網頁網址)、page_referrer (上一頁網址)

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%)

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

 

session_start

(應用程式、網站)

在有使用者與應用程式/網站互動時觸發  

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=""> 會與您透過進階設定指定收集的額外查詢參數相符)
這對您有幫助嗎?
我們應如何改進呢?

還有其他問題嗎?

登入即可獲得其他支援選項,快速解決您的問題