事件

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

通用 Analytics (分析) 和 GA4 的評估模型不同,建議您依 GA4 模型重新思考資料收集方式,而不要將現有的通用 Analytics (分析) 事件結構移植到 GA4。

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

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

通用 Analytics (分析)

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

以下是 analytics.jsgtag.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 中的 file_download 事件,所以可能不需要遷移至 GA4。

加強型評估

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

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

加強型評估覆寫

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

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

  1. 加強型評估中停用「檔案下載」功能。
  2. 視需要手動傳送含有自訂參數的 file_download 事件。
    • 由於系統透過加強型評估功能停用自動收集的事件,因此您必須手動設定通常會透過事件收集的參數,例如 file_extensionfile_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 通用 Analytics (分析) 事件

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

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

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

自訂事件

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

下例是測量 UI 方向選項變更的 analytics.js 通用 Analytics (分析) 事件

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

目前沒有可評估上方的通用 Analytics (分析) 事件的預先定義 GA4 事件。請參閱以下的 gtag.js 範例,瞭解如何使用自訂事件在 GA4 中評估相同互動:

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

如要在報表中加入 ui_elementconfiguration,您必須根據這些事件參數建立對應的維度。詳情請參閱「自訂維度和指標」一文。