事件

本文將說明如何將通用 Analytics (分析) 事件遷移至 Google Analytics (分析) 4 (GA4) 事件。

由於通用 Analytics (分析) 和 GA4 的評估模型不同，建議您根據 GA4 模型重新思考資料收集方式，而非將現有的通用 Analytics (分析) 事件結構改為 GA4。

如要進一步瞭解 GA4 事件，請參閱「事件簡介」一文。

比較通用 Analytics (分析) 和 GA4 事件

通用 Analytics (分析)

針對通用 Analytics (分析)，評估是透過傳送命中來進行。大多數命中類型是用來評估特定互動 (例如 pageview)，但 event 命中類型適用於自訂/一般評估。與 event 命中一起傳送的資料包括「類別」、「動作」和「標籤」。

以下是 analytics.js 和 gtag.js 程式庫的通用 Analytics (分析) 事件範例：

analytics.js (通用 Analytics (分析))

// Send an event using analytics.js.
ga('send', 'event', 'Settings', 'Enable', 'Dark mode');

// Alternatively, you can specify the event fields in the fieldsObject.
// The command above could be rewritten as:
ga('send', {
  hitType: 'event',
  eventCategory: 'Settings',
  eventAction: 'Enable',
  eventLabel: 'Dark mode'
});

gtag.js (通用 Analytics (分析))

gtag('event', 'Enable', {
  event_category: 'Settings',
  event_label: 'Dark mode'
});

Google Analytics (分析) 4

如果是 Google Analytics (分析) 4 (GA4)，系統會透過傳送事件執行評估。有些會自動收集的事件、預先定義的事件，也是系統為您建議的事件傳送；您也可以在自動或建議事件不符合用途時傳送自訂事件。

以下是 GA4 中的自訂事件範例：

gtag.js (GA4)

gtag('event', 'settings_update', {
  setting: 'mode',
  status : 'dark'
});

將通用 Analytics (分析) 事件對應至 GA4

如要將通用 Analytics (分析) 事件遷移至 GA4，您必須判斷是否有對等的 GA4 事件。如要將通用 Analytics (分析) 事件對應至 GA4，請使用下列步驟：

  1. 查看自動收集的事件清單。如果 GA4 自動收集的事件與通用 Analytics (分析) 事件密切相符，請移除通用 Analytics (分析) 事件，並依賴自動收集的事件。

  2. 如果您在上一個步驟中找不到相符項目，請查看透過加強型評估收集的事件。如果 GA4 加強型評估事件與通用 Analytics (分析) 事件的用途非常接近，請勿遷移通用 Analytics (分析) 事件，而是仰賴加強型評估傳送事件。請務必確認 GA4 資源的加強型評估設定正確無誤，這樣才能收集事件。

  3. 如果您在上一個步驟中找不到相符項目，請參閱建議事件清單。如果 GA4 建議事件與通用 Analytics (分析) 事件的目的密切相關，請使用建議事件，並在傳送事件時設定任何適用的事件參數。

  4. 如果您在上一個步驟中找不到相符項目，請傳送自訂事件。

遷移情境和範例

自動收集的事件

自動收集的事件一律會傳送，且通常無法停用 (除非透過加強型評估可進行設定)。一般而言，如果通用 Analytics (分析) 事件有相當對等的自動收集的事件，請勿遷移。

舉例來說，如果傳送用於評估檔案下載互動的通用 Analytics (分析) 事件，可能就無須遷移至 GA4，因為 GA4 中的 file_download 事件會自動收集。

加強型評估

一般來說，如果透過加強型評估功能收集足夠的 GA4 事件，您通常就不必將通用 Analytics (分析) 事件遷移至 GA4。舉例來說，下列通用 Analytics (分析) 事件已透過加強型評估在 GA4 中進行評估，因此可能不需要遷移至 GA4：

  • 評估外連點擊的通用 Analytics (分析) 事件相當於 GA4 中的 click 事件。
  • 用來評估檔案下載的通用 Analytics (分析) 事件，相當於 GA4 中的 file_download 事件。

加強型評估覆寫

如果加強型評估事件與通用 Analytics (分析) 事件相等，但無法擷取您需要的所有資料，您可以使用其他自訂參數，手動傳送事件。為此，您必須針對對應的事件設定/停用加強型評估功能，並手動傳送 GA4 事件。

舉例來說，透過加強型評估收集的 file_download 事件與通用 Analytics (分析) 事件高度相符，但缺少檔案大小相關資訊。如要覆寫加強型評估事件，並加入檔案大小資訊，請按照下列步驟操作：

  1. 停用加強型評估中的「檔案下載」功能。
  2. 請視情況使用自訂參數手動傳送 file_download 事件。
    • 由於自動收集的事件是透過加強型評估功能停用，因此您必須手動設定通常會透過事件收集的參數 (例如 file_extension、file_name 等)。
  3. 建立自訂維度/指標，以便在報表中查看所有自訂參數值。

以下 gtag.js 範例會傳送含有 file_size 自訂參數的 GA4 file_download 事件。

gtag('event', 'file_download', {
  file_extension: '.mp4',
  file_name: 'tutorial.mp4',
  link_url: '/videos/tutorial.mp4',
  link_text: 'Download the tutorial!',

  // Custom parameter.
  file_size: '275 MB'
});

如果通用 Analytics (分析) 事件具有足夠的對等 GA4 建議事件，請將通用 Analytics (分析) 事件遷移至建議事件。

以下範例是用來評估登入次數的 analytics.js UA 事件：

ga('send', 'event', 'login', 'google-sso');

GA4 login 事件可用於將通用 Analytics (分析) 事件遷移至 GA4。GA4 gtag.js 對等項目如下：

gtag('event', 'login', {
  method: 'google-sso'
});

自訂事件

如果通用 Analytics (分析) 事件沒有對應的自動收集、加強型評估或建議事件，請將通用 Analytics (分析) 事件遷移至自訂事件，然後視需要建立自訂維度和指標。

以下範例顯示的 analytics.js UA 事件會評估 UI 方向選項的變更：

ga('send', 'event', 'orientation', 'layout', 'wide');

沒有預先定義的 GA4 事件，無法評估上述通用 Analytics (分析) 事件。以下 gtag.js 範例顯示如何使用自訂事件在 GA4 中評估同一項互動：

gtag('event', 'orientation_update', {
  ui_element: 'layout',
  configuration: 'wide'
});

如要在報表中加入 ui_element 和 configuration，您需要使用這些事件參數建立對應的維度。詳情請參閱「自訂維度和指標」一文。