本文說明通用 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
|
|
僅限 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)
|
|
僅限 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)
|
|
僅限 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
|
|
僅限 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 資料。
|
|
僅限 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
|
|
僅限 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
|
|
僅限 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 (分析) 報表會是完整 / 不變。
|
無 |
|
事件僅適用於 GA4。 |
不相容*。
*通用 Analytics (分析) 導入作業不太可能傳送此事件,因為這不是建議事件。為確保 GA4 報表順利完成,您可以使用 GA4 格式,為通用 Analytics (分析) 導入這個事件。
如果您導入通用 Analytics (分析) 的 GA4 事件,事件就會顯示為沒有
items 資料的事件,但這可能不太實用。不會影響通用 Analytics (分析) 電子商務報表。 |
不相容。
系統會以「一般」的形式傳送事件命中,並以 event_category 的形式傳送 view_cart,而 value 參數則是 event_value 。event_action 系統不會傳送 items 資料。
通用 Analytics (分析) 電子商務報表通常不支援這個事件,因此不會帶來顯著影響。
|
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
|
|
僅限 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 (分析) 電子商務報表通常不支援這個事件,因此不會帶來顯著影響。
|
不適用 |
|
事件僅適用於 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
|
|
僅限 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
|
|
僅限 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
|
|
僅限 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 (分析) 報表會是完整 / 不變。
|