本頁面由 Cloud Translation API 翻譯而成。

GA4 電子商務 (gtag.js)：傳送 GA4 事件

本指南說明如何遷移現有的 gtag.js 通用 Analytics (分析) 電子商務導入作業，以使用 Google Analytics (分析) 4 電子商務事件。

如需其他遷移指南和資源，請前往開發人員遷移中心。

結果

本指南的結果是您將為新的 GA4 資源導入 Google Analytics (分析) 4 電子商務事件，並使用新的導入方式為現有的通用 Analytics (分析) 報表填入資料。現有的通用 Analytics (分析) 導入設定將變更為接收 GA4 電子商務資料。

事前準備

請使用電子商務遷移輔助工具，確認以下程式碼是否說明您目前的導入方式：
- 您正在使用通用 Analytics (分析) 資源
- 您的網站使用 gtag.js 程式庫傳送電子商務事件
請參閱電子商務導入作業的遷移選項，瞭解各選項的優缺點。確認是否要按照本指南，在現有的通用 Analytics (分析) 導入中使用 Google Analytics (分析) 4 電子商務事件。
請參閱事件相容性參考資料，瞭解在傳送至 GA4 資源時，系統如何轉譯通用 Analytics (分析) 事件。

取捨與注意事項

請詳閱並考量下方資訊，完整瞭解使用 Google Analytics (分析) 4 電子商務事件搭配現有的 gtag.js (通用 Analytics (分析)) 電子商務導入設定有哪些影響。

優點	缺點
可讓您在 GA4 和通用 Analytics (分析) 報表中查看電子商務資料。使用 GA4 事件和參數可確保完整的 GA4 電子商務報表。	您必須變更現有的電子商務事件。在通用 Analytics (分析) 中，並非所有 GA4 事件和參數都有對等項目。`shipping_tier`、`discount`、`currency`、`location_id`、`promotion_name` 和 `promotion_id` 參數沒有對應的通用 Analytics (分析) 對等項目，也不會顯示在通用 Analytics (分析) 報表中。

導入作業

1. 更新電子商務導入設定

更新現有的電子商務導入設定，從使用通用 Analytics (分析) 電子商務事件改用 Google Analytics (分析) 4 事件。完成這個步驟後，通用 Analytics (分析) 資源就能接收 GA4 電子商務事件。請參閱「權衡和注意事項」一節，瞭解這項更新可能帶來的影響。

為協助更新，請使用下列資源：

Google Analytics (分析) 4 電子商務指南，瞭解如何傳送 GA4 電子商務事件。
「通用 Analytics (分析) 和 GA4 事件的相容性」以及「通用 Analytics (分析) 和 GA4 的可比較參數」表格所提供的資訊。這項資訊可協助您將通用 Analytics (分析) 電子商務事件名稱和參數，對應至 Google Analytics (分析) 4 的對等事件和參數。
電子商務遷移輔助工具，可驗證電子商務事件是否已正確更新。

2. 建立及設定新的 GA4 資源

將電子商務導入設定更新為傳送 GA4 電子商務事件後，請完成下列任一選項，開始將資料傳送至新的 Google Analytics (分析) 4 資源。

方法 1：使用 GA4 設定輔助程式，並啟用已連結的網站代碼

GA4 設定輔助程式會自動建立新的 GA4 資源，並從通用 Analytics (分析) 資源複製下列設定：資源名稱、網站網址、時區和貨幣設定。這樣也可以啟用已連結的網站代碼功能，重複使用現有的通用 Analytics (分析) gtag.js 導入設定，以載入新的 GA4 資源。

按照「Google Analytics (分析) 4 設定輔助程式」一文所述的步驟，建立及設定新的 Google Analytics (分析) 4 資源。請務必勾選「允許使用現有代碼來收集資料」選項，以使用已連結的網站代碼功能。

方法 2：更新 gtag.js 程式碼片段

建立新的 Google Analytics (分析) 4 資源。
- 使用 Google Analytics (分析) 4 設定輔助程式新增 Google Analytics (分析) 4 資源。不過，在設定期間出現提示時，請取消勾選「Enable data collection with your existing tag」(使用現有代碼啟用資料收集) 選項。或者，您也可以在沒有 Google Analytics (分析) 4 設定輔助程式的情況下，建立 Google Analytics (分析) 4 資源。使用助理的好處是，可以複製通用 Analytics (分析) 資源中的部分基本設定。
找出 Google Analytics (分析) 4 資源的代碼 ID。
使用 config 指令搭配代碼 ID，在現有的 gtag.js 程式碼片段中加入 Google Analytics (分析) 4 資源。

以下是已設定通用 Analytics (分析) 和 Google Analytics (分析) 4 資源的 gtag.js 程式碼片段範例：

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=UA-XXXXX-Y"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'UA-XXXXX-Y');  // Universal Analytics property
  gtag('config', 'TAG_ID');  // Google Analytics 4 property
</script>