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

電子商務事件相容性和轉譯參考資料 (gtag.js)

本文說明通用 Analytics (分析) 和 Google Analytics (分析) 4 (GA4) 的電子商務事件相容性和轉譯方式。

背景

GA4 電子商務事件傳送至通用 Analytics (分析) 資源後，會自動轉譯為對等的通用 Analytics (分析) 事件。將通用 Analytics (分析) 電子商務事件傳送至 GA4 資源時，系統也會進行翻譯。本文件會說明翻譯的運作方式、事件的相容性，以及在依賴自動翻譯時需做出哪些取捨。

目的

通用 Analytics (分析) 和 GA4 電子商務事件的轉譯功能具有以下優點：

易於導入：使用現有的通用 Analytics (分析) 導入設定進行小幅更新，採用 GA4 電子商務解決方案。
不必進行雙重標記：您可以將同一個電子商務事件傳送至通用 Analytics (分析) 和 GA4 資源。這樣就能選擇轉換至 GA4，並保留通用 Analytics (分析) 的電子商務導入作業，不必維護雙重代碼設定。

取捨

相容性可讓您靈活選擇 GA4 遷移路徑，最適合滿足您維護通用 Analytics (分析) 導入作業的短期和長期需求。

大多數 GA4 電子商務事件/參數都與通用 Analytics (分析) 相容，反之亦然。在少數情況下，如果發生不相容的問題，則通用 Analytics (分析) 或 GA4 電子商務報表可能無法完全填入資料。

請務必詳閱每個遷移選項，進一步瞭解相容性和必要設定。

翻譯功能的運作方式

將 GA4 電子商務事件傳送至通用 Analytics (分析) 資源後，該事件會轉譯為對應的通用 Analytics (分析) (gtag.js) 電子商務事件。
- 通用 Analytics (分析) 事件參數會填入可比較的 GA4 參數中的值。如果 GA4 事件無法填入通用 Analytics (分析) 參數 (也就是沒有可比較的參數)，則當事件傳送至通用 Analytics (分析) 資源時，系統會忽略該參數。
將通用 Analytics (分析) (gtag.js) 電子商務事件傳送至 GA4 資源後，該事件會轉譯為對等的 GA4 電子商務事件。
- GA4 事件參數會填入可比較的通用 Analytics (分析) 參數中的值。如果無法在通用 Analytics (分析) 事件中填入 GA4 參數 (也就是沒有對等參數)，則事件傳送至 GA4 資源時會略過該參數。在某些情況下，如果通用 Analytics (分析) 參數沒有可比較的 GA4 參數，該參數會與 GA4 事件做為自訂參數一起傳送。
GA4 與通用 Analytics (分析) 的所有翻譯都會在用戶端執行。
預設啟用事件/參數翻譯功能，您不需要進行使用者設定，且無法停用。

通用 Analytics (分析) 和 GA4 的可比較參數

下表列出通用 Analytics (分析) 和 Google Analytics (分析) 4 的對等電子商務參數。

通用 Analytics (分析) 參數名稱	Google Analytics (分析) 4 參數名稱	附註
`affiliation`	`affiliation`
`checkout_step`
`checkout_option`
`content_type`
`coupon`	`coupon`
`currency`	`currency`	將通用 Analytics (分析) 事件傳送至 GA4 資源時，這個貨幣值會用於 GA4 `items[].currency` 參數。
	`location_id`
	`payment_type`
`shipping`	`shipping`
`shipping_tier`
`tax`	`tax`
`transaction_id`	`transaction_id`
`value`	`value`
`items[]`	`items[]`
`items[].name`	`items[].item_name`
`items[].id`	`items[].item_id`
	`items[].affiliation`
`items[].brand`	`items[].item_brand`
`items[].category`	`items[].item_category` `items[].item_category2` `items[].item_category3` `items[].item_category4` `items[].item_category5`	商品類別。最多可以指定 5 個階層。如要進一步瞭解通用 Analytics (分析) 和 GA4 事件之間如何翻譯類別，請參閱「類別參數翻譯」一文。
	`items[].currency`
`items[].coupon`	`items[].coupon`
	`items[].discount`
`items[].list_name`	`items[].item_list_name`
`items[].list_position`	`items[].index`
	`items[].location_id`
`items[].price`	`items[].price`
`items[].quantity`	`items[].quantity`
`items[].variant`	`items[].item_variant`
`promotions[]`		如果是 GA4，`items[]` 會搭配促銷活動專屬參數使用，例如 `items[].promotion_id`。
`promotions[].id`	`items[].promotion_id`	將通用 Analytics (分析) 事件傳送至 GA4 時，系統不會轉譯這些參數，反之亦然。
`promotions[].name`	`items[].promotion_name`	將通用 Analytics (分析) 事件傳送至 GA4 時，系統不會轉譯這些參數，反之亦然。
`promotions[].creative_name`
`promotions[].creative_slot`	`items[].creative_slot`	將通用 Analytics (分析) 事件傳送至 GA4 時，系統不會轉譯這些參數，反之亦然。

類別參數轉譯

將 GA4 事件傳送至通用 Analytics (分析) 時，系統會將類別參數的翻譯視為特殊情況處理，反之亦然。

如果是通用 Analytics (分析)，設定 items[].category 參數時，可使用 / 做為分隔符號，最多可以指定五個階層層級。在 Google Analytics (分析) 4 中，您可以使用列舉類別參數來指定最多五個階層層級：items[].item_category、items[].item_category2、items[].item_category3、items[].item_category4 和 items[].item_category5。

類別翻譯的運作方式如下：

針對轉譯為通用 Analytics (分析) 的 GA4 事件，列舉類別會合併為單一 category 參數，每個類別則以 / 分隔。
如果是轉譯為 GA4 的通用 Analytics (分析) 事件，系統會拆分類別參數值，填入對應的 GA4 列舉類別。
如果您打算將 GA4 事件傳送至通用 Analytics (分析)，建議不要在類別值中使用 / 字元，因為系統會在連結至通用 Analytics (分析) 時將其視為類別分隔符號。
無論定義的類別數量為何，系統只會使用前 5 個類別層級。

類別翻譯範例

以下範例顯示轉譯為 GA4 的通用 Analytics (分析) 類別參數。將 GA4 事件轉譯為通用 Analytics (分析) 時，同樣的原則也是一樣。

通用 Analytics (分析) 事件，這個類別定義了 5 個階層：

gtag("event", "add_to_cart", {
  items: [{
    ...
    category: "Apparel/Adult/Shirts/Crew/Short sleeve",
    ...
  }]
});

通用 Analytics (分析) 事件轉譯為 GA4 事件，並列舉以下類別：

gtag("event", "add_to_cart", {
  items: [{
    ...
    item_category: "Apparel",
    item_category2: "Adult",
    item_category3: "Shirts",
    item_category4: "Crew",
    item_category5: "Short sleeve",
    ...
  }]
});

通用 Analytics (分析) 和 GA4 事件的相容性

下表列出通用 Analytics (分析) 和 Google Analytics (分析) 4 的電子商務事件，以及將通用 Analytics (分析) 事件傳送至 GA4 時的翻譯行為，反之亦然。

針對資料表中的每一列，各資料欄均提供以下資訊：

「通用 Analytics (分析) 事件」和「GA4 事件」欄會根據要評估的項目，顯示可比較的事件。
「參數」會列出各通用 Analytics (分析) 和 GA4 事件之間沒有對等的參數。「僅限 GA4」會列出僅搭配 GA4 事件使用的參數，且「僅限通用 Analytics (分析)」會列出僅適用於通用 Analytics (分析) 事件的參數。
翻譯行為 (將通用 Analytics (分析) 傳送至 GA4) 說明瞭將通用 Analytics (分析) 事件傳送至 GA4 資源時的翻譯行為。附註將詳細說明已傳送的資料、與 GA4 事件的差異，以及對 GA4 報表的所有重大影響。
翻譯行為 (將 GA4 傳送至通用 Analytics (分析)) 說明瞭將通用 Analytics (分析) 事件傳送至 GA4 資源時的翻譯行為。附註說明已傳送的資料、與通用 Analytics (分析) 事件的差異，以及對通用 Analytics (分析) 報表的所有重大影響。

通用 Analytics (分析) 事件	Google Analytics (分析) 4 事件	參數	翻譯行為 (將通用 Analytics (分析) 傳送至 GA4)	翻譯行為 (將 GA4 傳送至通用 Analytics (分析))
`view_item_list`	`view_item_list`	僅限 GA4： `item_list_id` `item_list_name` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會轉譯並傳送包含對等通用 Analytics (分析) 參數的 GA4 參數。僅限 GA4 的參數不會傳送。系統會忽略事件層級的 `item_list_name` 參數，只會傳送商品層級的 `item_list_name`。已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。
`select_content (items)`	`select_item`	僅限 GA4： `item_list_id` `item_list_name` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id` 僅限通用 Analytics (分析)： `content_type`	不相容。系統會傳送 `select_content` 自訂事件和 `content_type` 自訂參數。系統不會傳送任何 `items` 資料。	不相容：通用 Analytics (分析) 事件命中會以 `event_category` 和 select_item 的形式傳送，做為 `event_action`。系統不會傳送任何 `items` 資料。
`select_content (promotions)`	`select_promotion`	僅限 GA4： `creative_name` `creative_slot` `location_id` `promotion_id` `promotion_name` `items` 僅限通用 Analytics (分析)： `content_type` `promotions`	不相容。會以 `content_type` 和 `promotions` 做為自訂參數傳送的 `select_content` 自訂事件。`promotions` 自訂參數不含任何實用的資料。	不相容：通用 Analytics (分析) 事件命中會以 `event_category` 和 select_promotion 的形式傳送，並以 `event_action` 的形式傳送。系統不會傳送任何 `promotions` 資料。
`view_item`	`view_item`	僅限 GA4： `currency` `value` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會轉譯並傳送包含對等通用 Analytics (分析) 參數的 GA4 參數。例外狀況是 `item_list_name`，系統不會傳送。在僅限 GA4 的參數中，`currency` 和 `value` 會與命中一起傳送，其格式為「貨幣」和「交易收益」。`event_value` 也設為 `value` 參數，以整數表示。請注意，從 GA4 轉譯至通用 Analytics (分析) 的譯文包括 `event_value`，但通常不適用於通用 Analytics (分析) 命中。已填入 GA4 資料的通用 Analytics (分析) 報表，大多會是完整 / 不變。項目清單名稱將遺失。
`add_to_wishlist` 通用 Analytics (分析) 不支援 `items` 資料。	`add_to_wishlist`	僅限 GA4： `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會以 ecommerce 的形式傳送對等的事件命中，並以 `event_action` 的形式傳送 add_to_wishlist，`value` 參數則以 `event_value` 形式傳送。`event_category` 已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。通用 Analytics (分析) 電子商務報表通常不支援這個事件，因此不會帶來顯著影響。
`add_to_cart`	`add_to_cart`	僅限 GA4： `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會轉譯並傳送包含對等通用 Analytics (分析) 參數的 GA4 參數。僅限 GA4* 的參數不會傳送。 *系統不會傳送 `item_list_name`，但這項行為與 gtag.js (UA) 一致，後者不會傳送 `list_name`。已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。
`remove_from_cart`	`remove_from_cart`	僅限 GA4： `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會轉譯並傳送包含對等通用 Analytics (分析) 參數的 GA4 參數。僅限 GA4* 的參數不會傳送。 *系統不會傳送 `item_list_name`，但這個行為與不會傳送 `list_name` 的 gtag.js (UA) 一致。已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。
無	`view_cart`	事件僅適用於 GA4。	不相容。通用 Analytics (分析) 導入作業不太可能傳送此事件，因為這不是建議事件。為確保 GA4 報表順利完成，您可以使用 GA4 格式，為通用 Analytics (分析) 導入這個事件。如果您導入通用 Analytics (分析) 的 GA4 事件，事件就會顯示為沒有 `items` 資料的事件，但這可能不太實用。不會影響通用 Analytics (分析) 電子商務報表。	不相容。系統會以「一般」的形式傳送事件命中，並以 `event_category` 的形式傳送 view_cart，而 `value` 參數則是 `event_value`。`event_action`系統不會傳送 `items` 資料。通用 Analytics (分析) 電子商務報表通常不支援這個事件，因此不會帶來顯著影響。
`begin_checkout`	`begin_checkout`	僅限 GA4： `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會轉譯並傳送包含對等通用 Analytics (分析) 參數的 GA4 參數。僅限 GA4* 的參數不會傳送。 *系統不會傳送 `item_list_name`，但這個行為與不會傳送 `list_name` 的 gtag.js (UA) 一致。 `begin_checkout` 實際上等同於傳送 `checkout_step` 設為 `1` 的 `checkout_progress` 事件。已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。
`add_payment_info`	`add_payment_info`	僅限 GA4： `currency` `value` `coupon` `payment_type` `items` 通用 Analytics (分析)：不適用：不支援參數。	不相容。通用 Analytics (分析) 不支援這個事件的參數，因此不會傳送任何項目。這樣雖然有效，但不太可能沒有幫助。任何需要事件參數的 GA4 報表都不會不完整。	相容。對等的事件命中會以 `event_category` 的形式傳送，ecommerce 做為 `event_action`，add_to_wishlist 和 `value` 參數 (轉換為整數) 以 `event_value` 傳送。請注意，從 GA4 轉譯至通用 Analytics (分析) 的譯文包括 `event_value`，但通常不適用於通用 Analytics (分析) 命中。已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。通用 Analytics (分析) 電子商務報表通常不支援這個事件，因此不會帶來顯著影響。
不適用	`add_shipping_info`	事件僅適用於 GA4。	不相容。通用 Analytics (分析) 導入作業不太可能傳送此事件，因為這不是建議事件。為確保 GA4 報表順利完成，您可以使用 GA4 格式，為通用 Analytics (分析) 導入這個事件。如果您導入通用 Analytics (分析) 的 GA4 事件，事件就會顯示為沒有 `items` 資料的事件，但這可能不太實用。不會影響通用 Analytics (分析) 電子商務報表。	不相容。事件命中會以 `event_category` 一般的形式傳送，add_shipping_info* 為 `event_action`，`value` 參數 (轉換為整數) 則以 `event_value` 傳送。GA4 `currency` 參數會與命中一起傳送，做為 currency。通用 Analytics (分析) 電子商務報表通常不支援這個事件，因此不會帶來顯著影響。
`checkout_progress` `set_checkout_option`	無	事件只適用於通用 Analytics (分析)。	系統會將事件視為自訂事件。系統只會傳送事件層級參數，不會傳送 `items` 資料。 GA4 電子商務報表通常不支援這些事件，因此不會帶來顯著影響。	無
`view_promotion`	`view_promotion`	僅限 GA4： `creative_name` `creative_slot` `location_id` `promotion_id` `promotion_name` `items` 僅限通用 Analytics (分析)： `promotions`	不相容。會以 `promotions` 做為自訂參數傳送的 `view_promotion` 自訂事件。`promotions` 自訂參數不含任何實用的資料。	不相容：系統會傳送通用 Analytics (分析) 事件命中，並以 engagement 做為 `event_category` 和 view_promotion 以 `event_action` 傳送。系統不會傳送任何 `promotions` 資料。該事件標示為非互動事件。
`purchase`	`purchase`	僅限 GA4： `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。系統會使用事件層級 `currency`，因為系統不支援項目層級的 `currency`。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會轉譯並傳送包含對等通用 Analytics (分析) 參數的 GA4 參數。僅限 GA4* 的參數不會傳送。 *系統不會傳送 `item_list_name`，但這個行為與不會傳送 `list_name` 的 gtag.js (UA) 一致。已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。
`refund`	`refund`	僅限 GA4： `affiliation` `items[].affiliation` `items[].currency` `items[].discount` `items[].item_list_id` `items[].location_id`	相容。所有通用 Analytics (分析) 參數都會轉譯為 GA4 對等項目並傳送。系統會使用事件層級 `currency`，因為系統不支援項目層級的 `currency`。只有「僅限 GA4」參數的 GA4 報表才會顯示不完整。	相容。系統會轉譯並傳送包含對等通用 Analytics (分析) 參數的 GA4 參數。僅限 GA4* 的參數不會傳送。 *系統不會傳送 `item_list_name`，但這個行為與不會傳送 `list_name` 的 gtag.js (UA) 一致。已填入 GA4 事件資料的通用 Analytics (分析) 報表會是完整 / 不變。

電子商務事件相容性和轉譯參考資料 (gtag.js)

背景

目的

取捨

翻譯功能的運作方式

通用 Analytics (分析) 和 GA4 的可比較參數

類別參數轉譯

通用 Analytics (分析) 和 GA4 事件的相容性

`view_item_list`

`select_item`

`select_promotion`

`view_item`

`add_to_wishlist`

`add_to_cart`

`remove_from_cart`

`view_cart`

`begin_checkout`

`add_payment_info`

`add_shipping_info`

`view_promotion`

`purchase`

`refund`