Thương mại điện tử nâng cao

Trang này mô tả cách sử dụng gtag.js để thu thập dữ liệu thương mại điện tử nâng cao. Nếu đã định cấu hình Google Analytics trong gtag.js và đã bật tính năng thương mại điện tử nâng cao trong Google Analytics, bạn có thể sử dụng gtag.js để gửi dữ liệu lượt hiển thị, dữ liệu sản phẩm, dữ liệu khuyến mãi và dữ liệu hành động đến Google Analytics.

Lưu ý: Google Analytics 4 là tương lai của Google Analytics. Vì lý do này, bạn nên triển khai sự kiện thương mại điện tử trên GA4 để đảm bảo bạn có thể tận dụng tất cả các tính năng của Google Analytics về lâu dài. Tìm hiểu thêm

Các hành động và loại dữ liệu thương mại điện tử nâng cao

Bạn có thể gửi nhiều loại dữ liệu thương mại điện tử:

• dữ liệu lượt hiển thị
• dữ liệu sản phẩm
• dữ liệu hành động
• loại hành động

Dữ liệu lượt hiển thị

Biểu thị thông tin về một sản phẩm đã được xem. Thuộc tính này được gọi là impressionFieldObject và chứa các giá trị sau:

Khoá	Loại giá trị	Bắt buộc	Nội dung mô tả
id	văn bản	*Có	Mã sản phẩm hoặc SKU (ví dụ: P67890). * Bạn phải đặt một trong số id hoặc name.
name	văn bản	*Có	Tên của sản phẩm (ví dụ: áo phông Android). * Bạn phải đặt một trong số id hoặc name.
list	văn bản	Không	Danh sách hoặc bộ sưu tập chứa sản phẩm (ví dụ: Kết quả tìm kiếm)
list_name	văn bản	Không	Danh sách hoặc bộ sưu tập chứa sản phẩm (ví dụ: Kết quả tìm kiếm)
brand	văn bản	Không	Thương hiệu liên kết với sản phẩm (ví dụ: Google).
category	văn bản	Không	Danh mục chứa sản phẩm (ví dụ: Quần áo). Sử dụng / làm dấu phân cách để chỉ định tối đa 5 cấp phân cấp (ví dụ: Trang phục/Nam/Áo phông).
variant	văn bản	Không	Biến thể của sản phẩm (ví dụ: Đen).
position	số nguyên	Không	Vị trí của sản phẩm trong danh sách hoặc bộ sưu tập (ví dụ: 2).
list_position	số nguyên	Không	Vị trí của sản phẩm trong danh sách hoặc bộ sưu tập (ví dụ: 2).
price	number	Không	Giá của một sản phẩm (ví dụ: 29.20).

Dữ liệu sản phẩm

Dữ liệu sản phẩm thể hiện từng sản phẩm riêng lẻ đã được xem, được thêm vào giỏ hàng, v.v. Dữ liệu này được gọi là productFieldObject và chứa các giá trị sau:

Khoá	Loại giá trị	Bắt buộc	Nội dung mô tả
id	văn bản	*Có	Mã sản phẩm hoặc SKU (ví dụ: P67890). * Bạn phải đặt một trong số các giá trị nhận dạng hoặc name.
name	văn bản	*Có	Tên của sản phẩm (ví dụ: áo phông Android). * Bạn phải đặt một trong số các giá trị nhận dạng hoặc name.
brand	văn bản	Không	Thương hiệu liên kết với sản phẩm (ví dụ: Google).
category	văn bản	Không	Danh mục chứa sản phẩm (ví dụ: Quần áo). Sử dụng / làm dấu phân cách để chỉ định tối đa 5 cấp phân cấp (ví dụ: Trang phục/Nam/Áo phông).
variant	văn bản	Không	Biến thể của sản phẩm (ví dụ: Đen).
price	number	Không	Giá của một sản phẩm (ví dụ: 29.20).
quantity	số nguyên	Không	Số lượng của một sản phẩm (ví dụ: 2).
coupon	văn bản	Không	Mã giảm giá liên kết với một sản phẩm (ví dụ: SUMMER_Sale13).
position	số nguyên	Không	Vị trí của sản phẩm trong danh sách hoặc bộ sưu tập (ví dụ: 2).
list_position	số nguyên	Không	Vị trí của sản phẩm trong danh sách hoặc bộ sưu tập (ví dụ: 2).

Dữ liệu khuyến mãi

Thể hiện thông tin về một chương trình khuyến mãi đã được xem. Thuộc tính này được gọi là promoFieldObject và chứa các giá trị sau:

Khoá	Loại giá trị	Bắt buộc	Nội dung mô tả
id	văn bản	*Có	Mã khuyến mãi (ví dụ: PROMO_1234). * Bạn phải đặt một trong số id hoặc name.
name	văn bản	*Có	Tên của chương trình khuyến mãi (ví dụ: Giảm giá mùa hè). * Bạn phải đặt một trong số id hoặc name.
creative	văn bản	Không	Mẫu quảng cáo được liên kết với chương trình khuyến mãi (ví dụ: spring_banner2).
creative_name	văn bản	Không	Tên của mẫu quảng cáo (ví dụ: spring_banner2).
position	văn bản	Không	Vị trí của mẫu quảng cáo (ví dụ: banner_slot_1).
creative_slot	văn bản	Không	Tên của vùng mẫu quảng cáo (ví dụ: banner_slot_1).

Dữ liệu hành động

Biểu thị thông tin về hành động liên quan đến thương mại điện tử đã diễn ra. Thuộc tính này được gọi là actionFieldObject và chứa các giá trị sau:

Khoá	Loại giá trị	Bắt buộc	Nội dung mô tả
id	văn bản	*Có	Mã giao dịch (ví dụ: T1234). * Bắt buộc nếu loại thao tác là purchase hoặc refund
affiliation	văn bản	Không	Cửa hàng hoặc đơn vị liên kết đã diễn ra giao dịch này (ví dụ: Google Store).
revenue	number	Không	Cho biết tổng doanh thu hoặc tổng doanh thu liên quan đến giao dịch (ví dụ: 11,99). Giá trị này có thể bao gồm chi phí vận chuyển, thuế hoặc các khoản điều chỉnh khác đối với tổng doanh thu mà bạn muốn đưa vào tính toán doanh thu. Lưu ý: Nếu bạn không đặt doanh thu, thì giá trị của doanh thu sẽ được tính tự động bằng cách sử dụng trường số lượng sản phẩm và giá của tất cả sản phẩm trong cùng một lượt truy cập.
value	number	Không	Giá trị (tức là doanh thu) liên quan đến sự kiện.
tax	number	Không	Tổng thuế liên quan đến giao dịch.
shipping	number	Không	Phí vận chuyển liên quan đến giao dịch.
coupon	văn bản	Không	Đã sử dụng phiếu giảm giá giao dịch cùng với giao dịch.
list	văn bản	Không	Danh sách chứa các sản phẩm được liên kết. Không bắt buộc.
items	mảng	Không	Mảng chứa các sản phẩm được liên kết.
step	số nguyên	Không	Số đại diện cho một bước trong quy trình thanh toán. Không bắt buộc trên các thao tác "checkout".
checkout_step	số nguyên	Không	Số đại diện cho một bước trong quy trình thanh toán.
option	văn bản	Không	Trường bổ sung cho những thao tác checkout và checkout_option có thể mô tả thông tin về lựa chọn trên trang thanh toán, chẳng hạn như phương thức thanh toán đã chọn.
checkout_option	văn bản	Không	Tuỳ chọn thanh toán (tức là phương thức thanh toán đã chọn).

Khoá	Loại giá trị	Bắt buộc	Nội dung mô tả
coupon	string	Không	Mã giảm giá cho một mặt hàng có thể mua được.

Hành động đối với sản phẩm và chương trình khuyến mãi

Hành động chỉ định cách diễn giải dữ liệu sản phẩm và chương trình khuyến mãi mà bạn gửi đến Google Analytics.

Hành động	Sự kiện	Nội dung mô tả
click	Lượt nhấp vào một sản phẩm hoặc đường liên kết đến một hoặc nhiều sản phẩm.
detail	Chế độ xem chi tiết sản phẩm.
add	Thêm một hoặc nhiều sản phẩm vào giỏ hàng.
remove	Xoá một hoặc nhiều sản phẩm khỏi giỏ hàng.
checkout	Bắt đầu quy trình thanh toán cho một hoặc nhiều sản phẩm.
checkout_option	Gửi giá trị tuỳ chọn cho một bước thanh toán nhất định.
purchase	Bán một hoặc nhiều sản phẩm.
refund	Khoản tiền hoàn lại cho một hoặc nhiều sản phẩm.
promo_click	Lượt nhấp vào chương trình khuyến mãi nội bộ.
add_to_cart	Người dùng thêm một hoặc nhiều sản phẩm vào giỏ hàng.
begin_checkout	Một người dùng bắt đầu quy trình thanh toán cho một hoặc nhiều sản phẩm.
checkout_progress	Người dùng hoàn tất các bước thanh toán sau bước thanh toán đầu tiên.
purchase	Người dùng hoàn tất một giao dịch mua hàng.
refund	Người dùng được hoàn tiền cho một hoặc nhiều sản phẩm.
remove_from_cart	Người dùng xoá một hoặc nhiều sản phẩm khỏi giỏ hàng.
select_content	Người dùng nhấp vào một sản phẩm hoặc đường liên kết đến sản phẩm.
set_checkout_option	Bước thanh toán mà người dùng đang hoàn tất.
view_item	Người dùng xem thông tin chi tiết về một sản phẩm.
view_item_list	Người dùng xem danh sách một hoặc nhiều sản phẩm.
view_promotion	Người dùng nhấp vào chương trình khuyến mãi nội bộ.
view_refund	Người dùng xem khoản tiền hoàn lại cho một hoặc nhiều sản phẩm.

Ví dụ

Đo lường số lượt hiển thị sản phẩm

Để đo lường số lượt hiển thị sản phẩm, hãy gửi view_item_list kèm theo thông tin sản phẩm:

gtag('event', 'view_item_list', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": 3
    }
  ]
});

Đo lường số lượt nhấp vào sản phẩm

Để đo lường một lượt nhấp vào sản phẩm, hãy gửi sự kiện select_content, chỉ định product làm content_type và cung cấp thông tin sản phẩm:

gtag('event', 'select_content', {
  "content_type": "product",
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": 2
    }
  ]
});

Đo lường lượt xem chi tiết sản phẩm

Sau khi nhấp vào trang thông tin sản phẩm, người dùng có thể xem trang chi tiết sản phẩm. Để đo lường lượt xem chi tiết sản phẩm, hãy gửi sự kiện view_item kèm theo thông tin chi tiết về sản phẩm:

gtag('event', 'view_item', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Đo lường lượt thêm vào và lượt xoá khỏi giỏ hàng

Để đo lường hoạt động thêm một sản phẩm vào giỏ hàng, hãy gửi sự kiện add_to_cart kèm theo thông tin sản phẩm:

gtag('event', 'add_to_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Để đo lường lượt loại bỏ một sản phẩm khỏi giỏ hàng, hãy gửi một sự kiện remove_from_cart kèm theo thông tin sản phẩm:

gtag('event', 'remove_from_cart', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ]
});

Đo lường quy trình thanh toán

Cách đo lường từng bước trong quy trình thanh toán:

1. Thêm mã đo lường để đo lường từng bước của quy trình thanh toán.
2. Nếu có thể, hãy thêm mã đo lường để ghi lại các lựa chọn thanh toán.

1. Đo lường các bước thanh toán

Để đo lường bước thanh toán đầu tiên, hãy gửi một sự kiện begin_checkout với các mặt hàng thanh toán:

gtag('event', 'begin_checkout', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": ""
});

Để đo lường từng bước thanh toán tiếp theo, hãy gửi một sự kiện checkout_progress với các mặt hàng thanh toán:

gtag('event', 'checkout_progress', {
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    }
  ],
  "coupon": "SUMMER_DISCOUNT"
});

2. Đo lường các lựa chọn thanh toán

Để đo lường một tuỳ chọn thanh toán, hãy gửi một sự kiện set_checkout_option có tuỳ chọn thanh toán:

gtag('event', 'set_checkout_option', {
  "checkout_step": 1,
  "checkout_option": "shipping method",
  "value": 3
});

Đo lường số lượt hiển thị của chương trình khuyến mãi

Để đo lường số lượt hiển thị chương trình khuyến mãi, hãy gửi một sự kiện view_promotion kèm theo thông tin về chương trình khuyến mãi:

gtag('event', 'view_promotion', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    },
    {
      "id": "xyz987",
      "name": "spring savings"
    }
  ]
});

Đo lường số lượt nhấp vào thông tin khuyến mãi

Để đo lường một lượt nhấp vào chương trình khuyến mãi, hãy gửi một sự kiện select_content và cung cấp chương trình khuyến mãi:

gtag('event', 'select_content', {
  "promotions": [
    {
      "id": "abc123",
      "name": "summer_promo"
    }
  ]
});

Đo lường lượt mua hàng

Để đo lường một giao dịch, hãy gửi một sự kiện purchase với các mục trong giao dịch đó:

gtag('event', 'purchase', {
  "transaction_id": "24.031608523954162",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});

Đo lường khoản tiền hoàn lại

Để đo lường khoản hoàn tiền toàn bộ của một giao dịch, hãy gửi sự kiện refund kèm theo mã giao dịch:

gtag('event', 'refund', { "transaction_id": "T12345" })

Để đo lường khoản hoàn tiền một phần, hãy gửi sự kiện refund kèm theo mã giao dịch và các mặt hàng cần được hoàn tiền:

gtag('event', 'refund', {
  "transaction_id": "79.18502354114992",
  "affiliation": "Google online store",
  "value": 23.07,
  "currency": "USD",
  "tax": 1.24,
  "shipping": 0,
  "items": [
    {
      "id": "P12345",
      "name": "Android Warhol T-Shirt",
      "list_name": "Search Results",
      "brand": "Google",
      "category": "Apparel/T-Shirts",
      "variant": "Black",
      "list_position": 1,
      "quantity": 2,
      "price": '2.0'
    },
    {
      "id": "P67890",
      "name": "Flame challenge TShirt",
      "list_name": "Search Results",
      "brand": "MyBrand",
      "category": "Apparel/T-Shirts",
      "variant": "Red",
      "list_position": 2,
      "quantity": 1,
      "price": '3.0'
    }
  ]
});