Tài liệu tham khảo về bản dịch và khả năng tương thích của sự kiện thương mại điện tử (gtag.js)

Tài liệu này mô tả khả năng tương thích và cơ chế chuyển đổi sự kiện thương mại điện tử giữa Universal Analytics (UA) và Google Analytics 4 (GA4).

Thông tin khái quát

Hệ thống sẽ tự động chuyển đổi sự kiện thương mại điện tử GA4 sang các sự kiện UA tương đương khi được gửi đến một tài sản UA. Quá trình dịch cũng diễn ra khi gửi sự kiện thương mại điện tử UA đến tài sản GA4. Tài liệu này giải thích cách hoạt động của tính năng dịch, khả năng tương thích của các sự kiện và mọi phương án đánh đổi mà bạn có thể phải đưa ra khi dựa vào tính năng dịch tự động.

Mục đích

Việc biên dịch giữa các sự kiện thương mại điện tử trong UA và GA4 giúp mang lại những lợi ích sau:

  • Dễ triển khai: sử dụng cấu hình thương mại điện tử trên GA4 bằng cách sử dụng cấu hình triển khai hiện tại trên UA với một bản cập nhật nhỏ về cấu hình.
  • Không cần phải gắn thẻ kép: bạn có thể gửi cùng một sự kiện thương mại điện tử đến một tài sản UA và GA4. Nhờ đó, bạn có thể chuyển đổi sang GA4 và tiếp tục triển khai sự kiện thương mại điện tử trên UA mà không cần duy trì cấu hình thẻ kép.

Đánh đổi

Khả năng tương thích giúp bạn linh hoạt lựa chọn một lộ trình di chuyển GA4 phù hợp nhất để đáp ứng các yêu cầu ngắn hạn và dài hạn của bạn về việc duy trì việc triển khai UA.

Hầu hết sự kiện/thông số thương mại điện tử trong GA4 đều tương thích với UA và ngược lại. Trong một số ít trường hợp không tương thích, tuỳ thuộc vào lựa chọn di chuyển của bạn, báo cáo thương mại điện tử UA hoặc GA4 có thể không được điền đầy đủ dữ liệu.

Bạn cần xem xét từng tuỳ chọn di chuyển để biết thông tin chi tiết về khả năng tương thích và cấu hình bắt buộc.

Cách hoạt động của tính năng dịch

  • Khi một sự kiện thương mại điện tử GA4 được gửi đến một tài sản UA, sự kiện đó sẽ được chuyển đổi sang sự kiện thương mại điện tử UA (gtag.js) tương đương.
    • Các thông số sự kiện UA được điền sẵn bằng giá trị từ các thông số GA4 tương đương. Nếu bạn không thể điền một thông số UA từ sự kiện GA4 (tức là không có thông số tương đương), thì thông số này sẽ bị bỏ qua khi sự kiện đó được gửi đến tài sản UA.
  • Khi một sự kiện thương mại điện tử trên UA (gtag.js) được gửi đến một tài sản GA4, sự kiện đó sẽ được chuyển đổi thành sự kiện thương mại điện tử GA4 tương đương.
    • Các thông số sự kiện GA4 được điền sẵn giá trị từ các thông số UA tương đương. Nếu bạn không thể điền thông số GA4 từ một sự kiện UA (tức là không có thông số tương đương), thì thông số này sẽ bị bỏ qua khi sự kiện được gửi đến tài sản GA4. Trong một số trường hợp, nếu một thông số UA không có thông số GA4 tương đương, thì thông số đó sẽ được gửi cùng với sự kiện GA4 dưới dạng thông số tuỳ chỉnh.
  • Tất cả quá trình chuyển đổi từ GA4 sang UA và ngược lại đều được thực hiện ở phía máy khách.
  • Tính năng dịch sự kiện/thông số được bật theo mặc định, không cần cấu hình người dùng và không thể tắt tính năng này.

Các thông số tương đương cho UA và GA4

Bảng sau đây trình bày các thông số thương mại điện tử tương đương cho Universal Analytics và Google Analytics 4.

Tên thông số Universal Analytics Tên thông số Google Analytics 4 Ghi chú
affiliation affiliation
checkout_step
checkout_option
content_type
coupon coupon
currency currency Khi bạn gửi một sự kiện UA đến một tài sản GA4, giá trị đơn vị tiền tệ này sẽ được dùng cho thông số items[].currency của GA4.
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
Danh mục của mặt hàng. Bạn có thể chỉ định tối đa 5 cấp phân cấp.

Hãy xem bài viết Chuyển đổi thông số danh mục để biết thông tin chi tiết về cách xử lý hoạt động chuyển đổi danh mục giữa các sự kiện UA và 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[] Đối với GA4, items[] được dùng với các thông số dành riêng cho chương trình khuyến mãi như items[].promotion_id.
promotions[].id items[].promotion_id Các thông số này không được chuyển đổi khi gửi sự kiện UA đến GA4 hoặc ngược lại.
promotions[].name items[].promotion_name Các thông số này không được chuyển đổi khi gửi sự kiện UA đến GA4 hoặc ngược lại.
promotions[].creative_name
promotions[].creative_slot items[].creative_slot Các thông số này không được chuyển đổi khi gửi sự kiện UA đến GA4 hoặc ngược lại.

Chuyển đổi tham số danh mục

Việc dịch thông số danh mục được xử lý như một trường hợp đặc biệt khi gửi sự kiện GA4 đến UA hoặc ngược lại.

Đối với Universal Analytics, khi đặt thông số items[].category, bạn sử dụng / làm dấu phân tách để chỉ định tối đa 5 cấp thứ bậc. Trong Google Analytics 4, bạn sử dụng các tham số danh mục được liệt kê để chỉ định tối đa 5 cấp hệ phân cấp: items[].item_category, items[].item_category2, items[].item_category3, items[].item_category4 và items[].item_category5.

Hành vi đối với việc dịch danh mục như sau:

  • Đối với các sự kiện GA4 được chuyển đổi sang UA, các danh mục liệt kê sẽ được kết hợp thành một thông số category duy nhất, mỗi danh mục được phân tách bằng /.
  • Đối với các sự kiện UA được chuyển đổi sang GA4, giá trị của thông số danh mục sẽ được phân tách để điền các danh mục được liệt kê trong GA4 tương ứng.
  • Nếu có ý định gửi các sự kiện GA4 đến UA, bạn không nên sử dụng ký tự / trong các giá trị danh mục, vì ký tự này sẽ được hiểu là dấu phân tách danh mục khi dịch sang UA.
  • Chỉ sử dụng 5 cấp danh mục đầu tiên, bất kể có bao nhiêu cấp được xác định.

Ví dụ về bản dịch danh mục

Các ví dụ sau đây cho thấy thông số danh mục UA được chuyển đổi sang GA4. Nguyên tắc này cũng được áp dụng khi chuyển đổi sự kiện GA4 sang UA.

Một sự kiện UA có một danh mục xác định 5 cấp phân cấp:

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

Sự kiện UA đã chuyển đổi thành sự kiện GA4, với các danh mục được liệt kê:

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

Khả năng tương thích giữa sự kiện UA và GA4

Bảng dưới đây cho thấy các sự kiện thương mại điện tử tương đương cho Universal Analytics và Google Analytics 4, cũng như hành vi chuyển đổi khi gửi sự kiện UA đến GA4 và ngược lại.

Đối với mỗi hàng trong bảng, mỗi cột cung cấp những thông tin sau:

  • Các cột sự kiện UA và sự kiện GA4 cho biết các sự kiện tương tự nhau dựa trên những sự kiện đó được dùng để đo lường.
  • Thông số liệt kê các thông số không có thông số tương đương giữa sự kiện UA và GA4 tương ứng. Chỉ GA4 liệt kê những thông số chỉ được dùng với sự kiện GA4 và chỉ UA liệt kê những thông số chỉ được dùng với sự kiện UA.
  • Hành vi dịch (Gửi UA đến GA4) mô tả hành vi dịch khi gửi sự kiện UA đến tài sản GA4. Ghi chú này cung cấp thông tin chi tiết về dữ liệu đã gửi, sự khác biệt so với sự kiện GA4 và mọi tác động đáng chú ý đối với báo cáo GA4.
  • Hành vi dịch (Gửi GA4 đến UA) mô tả hành vi dịch khi gửi sự kiện UA đến một tài sản GA4. Ghi chú này cung cấp thông tin chi tiết về dữ liệu đã gửi, sự khác biệt so với sự kiện UA và mọi tác động đáng chú ý đối với báo cáo UA.
Sự kiện trên UA Sự kiện GA4 Tham số Hành vi dịch
(Gửi UA đến GA4)		 Hành vi dịch
(Gửi GA4 đến UA)
view_item_list Chỉ dành cho GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

Các thông số GA4 có thông số UA tương đương sẽ được dịch và gửi. Hệ thống sẽ không gửi các thông số chỉ dành cho GA4. Thông số item_list_name ở cấp sự kiện sẽ bị bỏ qua mà chỉ gửi item_list_name ở cấp mặt hàng.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi.
select_content (items) Chỉ dành cho GA4:
item_list_id
item_list_name
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id

Chỉ dành cho UA:
content_type
 Không tương thích.

Sự kiện tuỳ chỉnh select_content và thông số tuỳ chỉnh content_type sẽ được gửi. Không có dữ liệu items nào được gửi. 		Không tương thích.

lượt truy cập sự kiện trên UA được gửi với chung là event_category và select_item là event_action. Không có dữ liệu items nào được gửi.
select_content (promotions) Chỉ dành cho GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Chỉ dành cho UA:
content_type
promotions
 Không tương thích.

Một sự kiện tuỳ chỉnh select_content được gửi kèm theo content_type và promotions làm thông số tuỳ chỉnh. Tham số tuỳ chỉnh promotions không chứa dữ liệu hữu ích nào. 		Không tương thích.

Lượt truy cập sự kiện trên UA được gửi với chung là event_category và select_promotion là event_action. Không có dữ liệu promotions nào được gửi.
view_item Chỉ dành cho GA4:
currency
value
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

Các thông số GA4 có thông số UA tương đương sẽ được dịch và gửi. Trường hợp ngoại lệ là item_list_name và giá trị này sẽ không được gửi. Trong các thông số chỉ dành cho GA4, currency và value được gửi cùng với lượt truy cập dưới dạng đơn vị tiền tệ và Doanh thu giao dịch. event_value cũng được đặt thành tham số value dưới dạng số nguyên. Xin lưu ý rằng bản dịch từ GA4 sang UA bao gồm event_value, nhưng giá trị này thường không được đặt cho các lượt truy cập UA.

Những báo cáo trong UA được điền dữ liệu từ GA4 sẽ hầu như hoàn chỉnh / không thay đổi. Tên danh sách mặt hàng sẽ bị thiếu.
add_to_wishlist*

*Dữ liệu items không được hỗ trợ cho UA.
Chỉ dành cho GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

lượt truy cập sự kiện tương đương sẽ được gửi kèm theo ecommerce là event_category, add_to_wishlist là event_action và thông số value là event_value.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi. Vì sự kiện này thường không được hỗ trợ trong các báo cáo thương mại điện tử UA nên sẽ không có tác dụng đáng kể.
add_to_cart Chỉ dành cho GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

Các thông số GA4 có thông số UA tương đương sẽ được dịch và gửi.* Hệ thống sẽ không gửi các thông số chỉ dành cho GA4.

*item_list_name không được gửi nhưng hành vi này nhất quán với gtag.js (UA) và không gửi list_name.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi.
remove_from_cart Chỉ dành cho GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

Các thông số GA4 có thông số UA tương đương sẽ được dịch và gửi.* Hệ thống sẽ không gửi các thông số chỉ dành cho GA4.

*item_list_name không được gửi nhưng hành vi này nhất quán với gtag.js (UA) và không gửi list_name.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi.
Không áp dụng Sự kiện chỉ được đề xuất cho GA4.
Không tương thích*.

*Hoạt động triển khai UA của bạn ít có khả năng sẽ gửi sự kiện này vì đây không phải là sự kiện được đề xuất. Để đảm bảo báo cáo GA4 hoàn chỉnh, bạn có thể triển khai sự kiện này cho UA bằng định dạng GA4.

Nếu bạn triển khai sự kiện GA4 cho UA, thì sự kiện đó sẽ xuất hiện dưới dạng sự kiện mà không có dữ liệu items. Điều này có thể không hữu ích lắm. Việc này sẽ không ảnh hưởng đến báo cáo thương mại điện tử trên UA.
Không tương thích.

Lượt truy cập sự kiện được gửi với chung là event_category, view_cart là event_action và thông số value là event_value. Chưa gửi được dữ liệu items.

Vì sự kiện này thường không được hỗ trợ trong các báo cáo thương mại điện tử UA nên sẽ không có tác dụng đáng kể.
begin_checkout Chỉ dành cho GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

Các thông số GA4 có thông số UA tương đương sẽ được dịch và gửi.* Hệ thống sẽ không gửi các thông số chỉ dành cho GA4.

*item_list_name không được gửi nhưng hành vi này nhất quán với gtag.js (UA) và không gửi list_name.

begin_checkout có hiệu quả tương đương với việc gửi một sự kiện checkout_progress có checkout_step được đặt thành 1.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi.
add_payment_info Chỉ dành cho GA4:
currency
value
coupon
payment_type
items

UA:
Không áp dụng: Các thông số không được hỗ trợ.
Không tương thích*.

*Vì UA không hỗ trợ các thông số cho sự kiện này, nên không có thông số nào được gửi. Cách này vẫn có hiệu quả nhưng có thể không thật sự hữu ích.

Những báo cáo GA4 yêu cầu bất kỳ thông số sự kiện nào sẽ không hoàn chỉnh.
Tương thích.

lượt truy cập sự kiện tương đương sẽ được gửi kèm theo ecommerce dưới dạng event_category, add_to_wishlist là event_action và thông số value (được chuyển thành số nguyên) là event_value. Xin lưu ý rằng bản dịch từ GA4 sang UA bao gồm event_value, nhưng giá trị này thường không được đặt cho các lượt truy cập UA.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi. Vì sự kiện này thường không được hỗ trợ trong các báo cáo thương mại điện tử UA nên sẽ không có tác dụng đáng kể.
Không áp dụng Sự kiện chỉ được đề xuất cho GA4.
Không tương thích*.

*Hoạt động triển khai UA của bạn ít có khả năng sẽ gửi sự kiện này vì đây không phải là sự kiện được đề xuất. Để đảm bảo báo cáo GA4 hoàn chỉnh, bạn có thể triển khai sự kiện này cho UA bằng định dạng GA4.

Nếu bạn triển khai sự kiện GA4 cho UA, thì sự kiện đó sẽ xuất hiện dưới dạng sự kiện mà không có dữ liệu items. Điều này có thể không hữu ích lắm. Việc này sẽ không ảnh hưởng đến báo cáo thương mại điện tử trên UA.
Không tương thích*.

Lượt truy cập sự kiện được gửi với chung là event_category, add_shipping_info là event_action và thông số value (chuyển thành số nguyên) là event_value. Thông số currency của GA4 được gửi cùng với lượt truy cập dưới dạng đơn vị tiền tệ.

Vì sự kiện này thường không được hỗ trợ trong các báo cáo thương mại điện tử UA nên sẽ không có tác dụng đáng kể.
checkout_progress
set_checkout_option 		Không áp dụng Sự kiện chỉ được đề xuất cho UA.
Sự kiện sẽ được coi là sự kiện tuỳ chỉnh. Hệ thống chỉ gửi thông số ở cấp sự kiện, dữ liệu items sẽ không được gửi.

Vì những sự kiện này thường không được hỗ trợ trong báo cáo thương mại điện tử GA4, nên chúng sẽ không có tác động đáng kể.
Không áp dụng
view_promotion Chỉ dành cho GA4:
creative_name
creative_slot
location_id
promotion_id
promotion_name
items

Chỉ dành cho UA:
promotions
 Không tương thích.

Một sự kiện tuỳ chỉnh view_promotion được gửi kèm theo promotions làm thông số tuỳ chỉnh. Tham số tuỳ chỉnh promotions không chứa dữ liệu hữu ích nào. 		Không tương thích.

lượt truy cập sự kiện trên UA được gửi kèm theo engagement dưới dạng event_category và view_promotion dưới dạng event_action. Không có dữ liệu promotions nào được gửi. Sự kiện này được đánh dấu là Sự kiện không phải lượt tương tác.
purchase Chỉ dành cho GA4:
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

currency ở cấp sự kiện được dùng vì currency cấp mặt hàng không được hỗ trợ.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

Các thông số GA4 có thông số UA tương đương sẽ được dịch và gửi.* Hệ thống sẽ không gửi các thông số chỉ dành cho GA4.

*item_list_name không được gửi nhưng hành vi này nhất quán với gtag.js (UA) và không gửi list_name.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi.
refund Chỉ dành cho GA4:
affiliation
items[].affiliation
items[].currency
items[].discount
items[].item_list_id
items[].location_id
Tương thích.

Tất cả thông số trong UA đều được chuyển đổi sang các thông số tương đương trong GA4 và được gửi đi.

currency ở cấp sự kiện được dùng vì currency cấp mặt hàng không được hỗ trợ.

Những báo cáo GA4 yêu cầu bất kỳ thông số chỉ GA4 nào sẽ không hoàn chỉnh.
Tương thích.

Các thông số GA4 có thông số UA tương đương sẽ được dịch và gửi.* Hệ thống sẽ không gửi các thông số chỉ dành cho GA4.

*item_list_name không được gửi nhưng hành vi này nhất quán với gtag.js (UA) và không gửi list_name.

Những báo cáo trong UA được điền dữ liệu từ sự kiện GA4 sẽ hoàn tất / không thay đổi.