GA4 頁面腳本事件的具體含義和觸發條件

Google Analytics 頁面腳本事件

當你通過某種方式，比如gtag.js，為網站新增 Google Analytics（GA4）腳本後，GA4 腳本會將頁面或使用者的某些狀況，作為事件傳送至 Google 伺服器。

在預設或經過設定的情況下，GA4 腳本會涉及以下常見的事件，first_visit，session_start，page_view，user_engagement，scroll，click，view_search_results，file_download。這些事件可能會被 GA4 腳本單獨傳送，也可能會在組合之後被一同傳送。

事件 first_visit

當資料串流對應的 GA4 腳本，認為使用者是第一次訪問網站時，會觸發first_visit事件。first_visit一般跟隨其他事件一起傳送，他通過要求參數_fv來表示，當_fv等於1或2時，表示 Google 伺服器應記錄first_visit事件。

由於 GA4 腳本會將資料串流資訊儲存在 Cookie 中，其 Cookie 名稱的格式為_ga和_ga_<id>，id為資料串流對應的評定 ID（多個資料串流會擁有多個_ga_<id>），因此，當瀏覽器中不存在資料串流對應的 Cookie 時，GA4 腳本將認定目前是一位新使用者。

事件 session_start

當 GA4 腳本認為新的工作階段已經開始時，會觸發session_start事件。與first_visit事件類似，session_start同樣是跟隨其他事件一同傳送的，他通過要求參數_ss來表示，當_ss等於1或2時，表示 Google 伺服器應記錄session_start事件。

在新的工作階段開始後，如果使用者處於不活動的時間超過工作階段逾時時間（預設為30分鐘），則認為該工作階段結束，之後出現的活動將觸發新的工作階段，這裏的活動可以指任何用於讓 GA4 腳本觸發事件的行為。一個工作階段表示了一段時間內使用者的行為和頁面狀態，他們之間具有較強的關聯性。

事件 page_view

page_view事件會在網頁載入時觸發，預設情況下，這包含了歷程記錄操作（上一頁，下一頁）的載入，以及重新整理頁面。

事件 user_engagement

事件user_engagement用於傳送使用者在目前工作階段中的互動時間，互動時間被認為是頁面獲得使用者關註的時間，GA4 腳本中的互動工作階段計時器，會排除非互動時間的統計，比如，排除頁面被隱藏時的時間。

user_engagement通常在頁面關閉時或某個不確定的時間點觸發，他擁有以下重要的要求參數。

_et 要求參數

GA4 腳本計算出的互動時間會通過要求參數_et傳送至伺服器，這裏需要說明，_et表示的是本次事件與上一次事件之間，所產生的互動時間總和，以毫秒為單位。

事件 scroll

當使用者將頁面向下捲動到一定範圍（預設到達底端90%以下）時，事件scroll將被觸發。該事件可作為評定頁面質量的輔助指標，因為對於篇幅較長內容較多的頁面，使用者可能只對頁面的前半段內容感興趣，scroll事件根本沒有觸發機會。

scroll事件擁有以下重要的要求參數。

epn.percent_scrolled 要求參數

epn.percent_scrolled表示了捲軸捲動的百分比，預設情況下，他總是為90。

事件 click

使用者在頁面中點選是非常常見的操作，GA4 腳本一般只會記錄外連點選，當一個指向你的站點以外的連結被點選時，就會觸發click事件。

外連點選的click事件擁有以下重要的要求參數。

ep.outbound 要求參數

ep.outbound要求參數總是為true，以表示這是一個外連點選。

ep.link_id 要求參數

ep.link_id要求參數表示a元素的id屬性。

ep.link_classes 要求參數

ep.link_classes要求參數表示a元素的class屬性。

ep.link_url 要求參數

ep.link_url要求參數表示a元素指向的 URL。

ep.link_domain 要求參數

ep.link_domain要求參數表示a元素指向的網域名稱。

事件 view_search_results

當瀏覽器中的 URL 具有特定查詢參數時，事件view_search_results會被觸發，這通常表示使用者試圖查詢或希望得到更加精準的結果。

在預設情況下，以下 URL 查詢參數是被監視的，q，s，search，query，keyword。他們會被 GA4 腳本依次檢查，當某個查詢參數具有有效值時，其值將通過view_search_results的要求參數ep.search_term傳送至 Google 伺服器。假設，URL 中包含search=Tom，那麽Tom將成為要求參數ep.search_term的值。

事件 file_download

使用者在頁面中點選指向特定副檔名的檔案連結時，就會觸發file_download事件。在預設情況下，GA4 腳本將監視副檔名符合如下正規表達式的檔案的下載，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_download事件擁有以下重要的要求參數。

ep.file_name 要求參數

ep.file_name要求參數表示下載檔案的檔案名，他對應了 URL 中的路徑部分。

ep.file_extension 要求參數

ep.file_extension要求參數表示下載檔案的副檔名。

ep.link_text 要求參數

ep.link_text要求參數表示a元素所顯示的文字。

ep.link_id 要求參數

ep.link_id要求參數表示a元素的id屬性。

ep.link_url 要求參數

ep.link_url要求參數表示a元素指向的 URL。