Sự kiện đề xuất

Những sự kiện này cho phép bạn đo lường các tính năng và hành vi khác, đồng thời tạo ra thêm nhiều các báo cáo hữu ích trong Google Analytics 4. Vì những sự kiện này yêu cầu bổ sung ngữ cảnh có ý nghĩa thì chúng sẽ không được gửi tự động. Sử dụng tài liệu này để xem các thông số bắt buộc và không bắt buộc cho từng sự kiện.

Thẻ Google Trình quản lý thẻ Firebase

add_payment_info

Sự kiện này cho thấy một người dùng đã gửi thông tin thanh toán trong quy trình thanh toán thương mại điện tử.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
payment_type	string	Không	Thẻ tín dụng	Phương thức thanh toán đã chọn.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: add_payment_info
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Phiếu giảm giá thương mại điện tử - ecommerce.coupon
• Hình thức thanh toán thương mại điện tử – ecommerce.payment_type
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• coupon – {{Phiếu giảm giá thương mại điện tử}}
• payment_type – {{Hình thức thanh toán thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng add_payment_info

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: add_payment_info
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_payment_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    payment_type: "Credit Card",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_shipping_info

Sự kiện này cho thấy một người dùng đã gửi thông tin vận chuyển trong một quy trình thanh toán thương mại điện tử.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
shipping_tier	string	Không	Mặt đất	Cấp vận chuyển (ví dụ: Ground, Air, Next-day) được chọn để giao mặt hàng đã mua.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: add_shipping_info
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Phiếu giảm giá thương mại điện tử - ecommerce.coupon
• Cấp vận chuyển thương mại điện tử – ecommerce.shipping_tier
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• coupon – {{Phiếu giảm giá thương mại điện tử}}
• shipping_tier – {{Cấp vận chuyển thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng add_shipping_info

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: add_shipping_info
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_shipping_info",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping_tier: "Ground",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_cart

Sự kiện này cho biết một mặt hàng đã được thêm vào giỏ hàng để mua hàng.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: add_to_cart
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng add_to_cart

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: add_to_cart
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

add_to_wishlist

Sự kiện này cho biết rằng một mặt hàng đã được thêm vào danh sách yêu thích. Sử dụng sự kiện này để xác định các món quà phổ biến trong ứng dụng của bạn.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: add_to_wishlist
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng add_to_wishlist

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: add_to_wishlist
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "add_to_wishlist",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

begin_checkout

Sự kiện này biểu thị rằng người dùng đã bắt đầu quy trình thanh toán.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: begin_checkout
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Phiếu giảm giá thương mại điện tử - ecommerce.coupon
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• coupon – {{Phiếu giảm giá thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng Started_checkout

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: begin_checkout
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "begin_checkout",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    coupon: "SUMMER_FUN",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

close_convert_lead

Sự kiện này đo lường thời điểm một khách hàng tiềm năng đã được chuyển đổi và đã chốt (ví dụ: thông qua một giao dịch mua hàng).

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: close_convert_lead
• Thông số sự kiện (Tên thông số – Giá trị):
• currency – USD
• value – 30,03
• Kích hoạt sự kiện khi người dùng trở thành khách hàng tiềm năng đã chuyển đổi (khách hàng)

close_unconvert_lead

Sự kiện này đo lường thời điểm một người dùng được đánh dấu là chưa trở thành khách hàng tiềm năng đã chuyển đổi, kèm theo lý do.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
unconvert_lead_reason	string	Không	Chưa từng trả lời	Lý do khiến khách hàng tiềm năng không được chuyển đổi.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: close_unconvert_lead
• Thông số sự kiện (Tên thông số – Giá trị):
• currency – USD
• value – 30,03
• Kích hoạt sự kiện khi một người dùng được đánh dấu là chưa trở thành khách hàng tiềm năng đã chuyển đổi vì một trong vài lý do

disqualify_lead

Sự kiện này đo lường thời điểm một người dùng được đánh dấu là không đủ điều kiện để trở thành khách hàng tiềm năng, cùng với lý do không đủ điều kiện.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
disqualified_lead_reason	string	Không	Không muốn mua	Lý do mà một khách hàng tiềm năng được đánh dấu là không đủ tiêu chuẩn.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: disqualify_lead
• Thông số sự kiện (Tên thông số – Giá trị):
• currency – USD
• value – 30,03
• disqualified_lead_reason – Không tìm mua
• Kích hoạt sự kiện khi một người dùng được đánh dấu là không đủ điều kiện để trở thành khách hàng tiềm năng vì một trong vài lý do

earn_virtual_currency

Sự kiện này đo lường thời điểm người dùng được thưởng tiền ảo trong một trò chơi. Hãy ghi nhật ký này cùng với spend_virtual_currency để hiểu rõ hơn về kinh tế ảo.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
virtual_currency_name	string	Không	Gem	Tên đơn vị tiền tệ ảo.
value	number	Không	5	Giá trị của đơn vị tiền tệ ảo.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: earn_virtual_currency
• Thông số sự kiện (Tên thông số – Giá trị):
• virtual_currency_name - Ngọc
• value – 5
• Kích hoạt sự kiện khi người dùng được tặng tiền ảo

generate_lead

Sự kiện này đo lường thời điểm một khách hàng tiềm năng đã được tạo (ví dụ: thông qua một biểu mẫu). Ghi lại thông tin này để nắm được mức độ hiệu quả của các chiến dịch tiếp thị và có bao nhiêu khách hàng tương tác lại với doanh nghiệp của bạn sau khi tiếp thị lại khách hàng.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của value của sự kiện, theo 3 chữ cái Định dạng ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
lead_source	string	Không	Triển lãm thương mại	Nguồn của khách hàng tiềm năng.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: generate_lead
• Thông số sự kiện (Tên thông số – Giá trị):
• currency – USD
• value – 30,03
• lead_source - Triển lãm thương mại
• Kích hoạt sự kiện khi khách hàng tiềm năng đã được tạo

join_group

Ghi lại sự kiện này khi người dùng tham gia một nhóm như bang hội, nhóm hoặc gia đình. Sử dụng sự kiện này để phân tích mức độ phổ biến của một số nhóm hoặc tính năng xã hội nhất định.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
group_id	string	Không	G_12345	Mã của nhóm.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: join_group
• Thông số sự kiện (Tên thông số – Giá trị):
• group_id – G_12345
• Kích hoạt sự kiện khi người dùng tham gia một nhóm

level_end

Sự kiện này báo hiệu rằng người chơi đã đạt đến cuối một cấp độ trong trò chơi.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
level_name	string	Không	Hành trình bắt đầu...	Tên cấp độ.
success	boolean	Không	đúng	Đặt thành true nếu hoàn thành cấp độ.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: level_end
• Thông số sự kiện (Tên thông số – Giá trị):
• level_name – Hành trình bắt đầu...
• thành công - đúng
• Kích hoạt khi người chơi đã chơi đến cuối một cấp (ví dụ: trang xác nhận cấp độ)

level_start

Sự kiện này báo hiệu rằng người chơi đã bắt đầu một cấp độ trong trò chơi.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
level_name	string	Không	Hành trình bắt đầu...	Tên cấp độ.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: level_start
• Thông số sự kiện (Tên thông số – Giá trị):
• level_name – Hành trình bắt đầu...
• Kích hoạt khi người dùng bắt đầu một cấp mới (ví dụ: trang chủ của cấp độ)

level_up

Sự kiện này báo hiệu rằng một người chơi đã lên cấp trong trò chơi. Sử dụng báo cáo này để đánh giá cơ sở người dùng theo cấp và xác định các mức độ khó đã hoàn tất.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
level	number	Không	5	Cấp độ của nhân vật.
character	string	Không	Người chơi 1	Nhân vật đã lên cấp.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: level_up
• Thông số sự kiện (Tên thông số - Giá trị):
• level – 5
• character – Người chơi 1
• Kích hoạt khi người chơi lên cấp

đăng nhập

Gửi sự kiện này để báo hiệu rằng một người dùng đã đăng nhập vào trang web hoặc ứng dụng của bạn.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
method	string	Không	Google	Phương thức dùng để đăng nhập.

Ví dụ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: login
• Thông số sự kiện (Tên thông số – Giá trị):
• method - Google
• Kích hoạt khi người dùng đã đăng nhập

post_score

Gửi sự kiện này khi người dùng đăng điểm số. Hãy sử dụng sự kiện này để tìm hiểu đang hoạt động hiệu quả như thế nào trong trò chơi của bạn và tạo mối liên hệ giữa điểm số cao với đối tượng hoặc của Google.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
score	number	Có	10000	Tỷ số cần đăng.
level	number	Không	5	Cấp độ cho điểm số.
character	string	Không	Người chơi 1	Nhân vật đã ghi điểm số.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: post_score
• Thông số sự kiện (Tên thông số – Giá trị):
• score – 10.000
• level – 5
• character – Người chơi 1
• Kích hoạt khi người dùng đăng điểm số

purchase

Sự kiện này cho biết thời điểm một người dùng đã mua một hoặc nhiều mặt hàng.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
transaction_id	string	Có	T_12345	Giá trị nhận dạng riêng biệt của một giao dịch. Thông số transaction_id giúp bạn tránh lấy các sự kiện trùng lặp cho một giao dịch mua hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
shipping	number	Không	3,33	Phí vận chuyển liên quan đến một giao dịch.
tax	number	Không	1,11	Chi phí thuế liên quan đến một giao dịch.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: purchase
• Mặt hàng thương mại điện tử – ecommerce.items
• Mã giao dịch thương mại điện tử – ecommerce.transaction_id
• Giá trị thương mại điện tử – ecommerce.value
• Thuế thương mại điện tử – ecommerce.tax
• Giao hàng thương mại điện tử - ecommerce.shipping
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Phiếu giảm giá thương mại điện tử - ecommerce.coupon
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• transaction_id – {{Mã giao dịch thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• tax – {{Thuế thương mại điện tử}}
• shipping – {{Vận chuyển thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• coupon – {{Phiếu giảm giá thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện tương đương với lượt mua hàng

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: purchase
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "purchase",
  ecommerce: {
    transaction_id: "T_12345",
    // Sum of (price * quantity) for all items.
    value: 72.05,
    tax: 3.60,
    shipping: 5.99,
    currency: "USD",
    coupon: "SUMMER_SALE",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

qualify_lead

Sự kiện này đo lường thời điểm một người dùng được đánh dấu là đáp ứng các tiêu chí để trở thành khách hàng tiềm năng đủ tiêu chuẩn.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: qualify_lead
• Thông số sự kiện (Tên thông số – Giá trị):
• currency – USD
• value – 30,03
• Kích hoạt sự kiện khi một người dùng được đánh dấu là phù hợp với tiêu chí để trở thành khách hàng tiềm năng đủ tiêu chuẩn

refund

Sự kiện này cho biết thời điểm một hoặc nhiều mặt hàng được hoàn tiền cho người dùng.

Lưu ý: Bạn nên đưa thông tin mặt hàng vào sự kiện refund để xem các chỉ số về việc hoàn tiền ở cấp mặt hàng trong Analytics.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
transaction_id	string	Có	T_12345	Giá trị nhận dạng riêng biệt của một giao dịch.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
shipping	number	Không	3,33	Phí vận chuyển liên quan đến một giao dịch.
tax	number	Không	1,11	Chi phí thuế liên quan đến một giao dịch.
items	Array<Item>	Không*		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: refund
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Mã giao dịch thương mại điện tử – ecommerce.transaction_id
• Giá trị thương mại điện tử – ecommerce.value
• Thuế thương mại điện tử – ecommerce.tax
• Giao hàng thương mại điện tử - ecommerce.shipping
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Phiếu giảm giá thương mại điện tử - ecommerce.coupon
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• transaction_id – {{Mã giao dịch thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• tax – {{Thuế thương mại điện tử}}
• shipping – {{Vận chuyển thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• coupon – {{Phiếu giảm giá thương mại điện tử}}
• Kích hoạt: sự kiện bằng tiền hoàn lại

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: refund
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "refund",
  ecommerce: {
    currency: "USD",
    transaction_id: "T_12345", // Transaction ID. Required for purchases and refunds.
    value: 30.03,
    coupon: "SUMMER_FUN",
    shipping: 3.33,
    tax: 1.11,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

remove_from_cart

Sự kiện này cho biết rằng một mặt hàng đã bị xoá khỏi giỏ hàng.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: remove_from_cart
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng remove_from_cart

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: remove_from_cart
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "remove_from_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

tìm-kiếm

Ghi lại sự kiện này để cho biết thời điểm người dùng đã thực hiện tìm kiếm. Bạn có thể dùng sự kiện này để xác định người dùng đang tìm kiếm nội dung gì trên trang web hoặc ứng dụng của bạn. Cho Ví dụ: bạn có thể gửi sự kiện này khi người dùng xem một trang kết quả tìm kiếm sau thực hiện tìm kiếm.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
search_term	string	Có	áo phông	Cụm từ được tìm kiếm.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: search
• Thông số sự kiện (Tên thông số – Giá trị):
• search_term - áo phông
• Kích hoạt khi người dùng tìm thông tin trên trang web của bạn

select_content

Sự kiện này cho thấy người dùng đã chọn một số nội dung thuộc một loại nhất định. Sự kiện này có thể giúp bạn xác định nội dung phổ biến và các danh mục nội dung trên trang web hoặc ứng dụng của bạn.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
content_type	string	Không	sản phẩm	Loại nội dung đã chọn.
content_id	string	Không	C_12345	Giá trị nhận dạng cho nội dung đã chọn.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: select_content
• Thông số sự kiện (Tên thông số – Giá trị):
• content_type – sản phẩm
• content_id – C_12345
• Điều kiện kích hoạt: sự kiện = Select_content

select_item

Sự kiện này biểu thị một mục đã được chọn từ danh sách.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng.
items	Array<Item>	Có*		Các mặt hàng cho sự kiện. * Mảng items dự kiến sẽ có một đại diện cho mục đã chọn. Nếu nhiều phần tử được cung cấp, chỉ có phần tử đầu tiên trong items được sử dụng.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: select_item
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Mã danh sách mục thương mại điện tử – ecommerce.item_list_id
• Tên danh sách mục thương mại điện tử – ecommerce.item_list_name
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• item_list_id – {{Mã danh sách mặt hàng thương mại điện tử}}
• item_list_name – {{Tên danh sách mặt hàng thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng Select_item

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: select_item
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_item",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

select_promotion

Sự kiện này biểu thị một chương trình khuyến mãi đã được chọn từ danh sách.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Bỏ qua nếu thiết lập ở cấp mặt hàng.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng.
items	Array<Item>	Không		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Tên mẫu quảng cáo thương mại điện tử – ecommerce.creative_name
• Vị trí mẫu quảng cáo thương mại điện tử – ecommerce.creative_slot
• Mã khuyến mãi thương mại điện tử – ecommerce.promotion_id
• Tên chương trình khuyến mãi thương mại điện tử – ecommerce.promotion_name
• Mặt hàng thương mại điện tử – ecommerce.items
• Thông số sự kiện (Tên thông số – Giá trị):
• creative_name – {{Tên mẫu quảng cáo thương mại điện tử}}
• creative_slot – {{Vị trí quảng cáo thương mại điện tử}}
• promotion_id – {{Mã khuyến mãi thương mại điện tử}}
• promotion_name – {{Tên chương trình khuyến mãi thương mại điện tử}}
• items – {{Mặt hàng thương mại điện tử}}
• Loại biến: Biến lớp dữ liệu - 'ecommerce.items'
• Điều kiện kích hoạt: sự kiện bằng Select_promotion

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: select_promotion
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "select_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

chia sẻ

Sử dụng sự kiện này khi người dùng đã chia sẻ nội dung.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
method	string	Không	Twitter	Phương thức chia sẻ nội dung.
content_type	string	Không	hình ảnh	Loại nội dung được chia sẻ.
item_id	string	Không	C_12345	Mã của nội dung được chia sẻ.

Ví dụ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: share
• Thông số sự kiện (Tên thông số – Giá trị):
• method – Twitter
• content_type – hình ảnh
• item_id – C_12345
• Kích hoạt khi người dùng đã chia sẻ nội dung

sign_up

Sự kiện này cho biết rằng người dùng đã đăng ký tài khoản. Sử dụng sự kiện này để tìm hiểu các hành vi khác nhau của người dùng đã đăng nhập và không đăng xuất.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
method	string	Không	Google	Phương thức dùng để đăng ký.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: sign_up
• Thông số sự kiện (Tên thông số – Giá trị):
• method - Google
• Kích hoạt khi người dùng đã đăng ký tài khoản

spend_virtual_currency

Sự kiện này đo lường hoạt động bán hàng hoá ảo trong ứng dụng của bạn và giúp bạn xác định loại hàng hoá ảo phổ biến nhất.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
value	number	Có	5	Giá trị của đơn vị tiền tệ ảo.
virtual_currency_name	string	Có	Gem	Tên đơn vị tiền tệ ảo.
item_name	string	Không	Tăng cường khởi đầu	Tên của mặt hàng mà đơn vị tiền tệ ảo đang được sử dụng.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: spend_virtual_currency
• Thông số sự kiện (Tên thông số – Giá trị):
• value – 5
• virtual_currency_name - Ngọc
• item_name – Tăng cường cho người mới bắt đầu
• Kích hoạt khi có người mua hàng hoá ảo

tutorial_begin

Sự kiện này biểu thị việc bắt đầu quy trình giới thiệu. Sử dụng báo cáo này trong một phễu bằng tutorial_complete để biết có bao nhiêu người dùng hoàn thành hướng dẫn.

Thông số

Không có thông số nào cho sự kiện này.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: tutorial_begin
• Kích hoạt khi có người bắt đầu quy trình giới thiệu

tutorial_complete

Sự kiện này cho biết người dùng đã hoàn tất quy trình giới thiệu. Sử dụng bản thảo này trong phễu có tutorial_begin để biết có bao nhiêu người dùng hoàn tất của chúng tôi.

Thông số

Không có thông số nào được đề xuất cho sự kiện này.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: tutorial_complete
• Kích hoạt khi có người hoàn tất quy trình giới thiệu

unlock_achievement

Ghi lại sự kiện này khi người dùng đã mở khoá một thành tích. Sự kiện này có thể giúp bạn hiểu cách người dùng trải nghiệm trò chơi của mình.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
achievement_id	string	Có	A_12345	Mã của thành tích đã được mở khoá.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: unlock_achievement
• Thông số sự kiện (Tên thông số – Giá trị):
• achievement_id – A_12345
• Kích hoạt khi người dùng đã mở khóa một thành tích

view_cart

Sự kiện này cho thấy rằng một người dùng đã xem giỏ hàng.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: view_cart
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng view_cart

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: view_cart
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_cart",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item

Sự kiện này cho thấy rằng một số nội dung đã được hiển thị cho người dùng. Sử dụng sự kiện này để khám phá những mặt hàng được xem nhiều nhất.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: view_item
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Giá trị thương mại điện tử – ecommerce.value
• Đơn vị tiền tệ thương mại điện tử - ecommerce.currency
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• value – {{Giá trị thương mại điện tử}}
• currency – {{Đơn vị tiền tệ thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng view_item

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: view_item
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item",
  ecommerce: {
    currency: "USD",
    value: 30.03,
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

view_item_list

Ghi lại sự kiện này khi người dùng được xem danh sách các mục của danh mục nhất định.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng.
items	Array<Item>	Có		Các mặt hàng cho sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: view_item_list
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Mặt hàng thương mại điện tử – ecommerce.items
• Mã danh sách mục thương mại điện tử – ecommerce.item_list_id
• Tên danh sách mục thương mại điện tử – ecommerce.item_list_name
• Thông số sự kiện (Tên thông số – Giá trị):
• items – {{Mặt hàng thương mại điện tử}}
• item_list_id – {{Mã danh sách mặt hàng thương mại điện tử}}
• item_list_name – {{Tên danh sách mặt hàng thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện bằng view_item_list

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: view_item_list
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_item_list",
  ecommerce: {
    item_list_id: "related_products",
    item_list_name: "Related products",
    items: [
     {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.03,
      quantity: 3
    },
    {
      item_id: "SKU_12346",
      item_name: "Google Grey Women's Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 3.33,
      index: 1,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "gray",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 21.01,
      promotion_id: "P_12345",
      promotion_name: "Summer Sale",
      quantity: 2
    }]
  }
});

view_promotion

Sự kiện này cho biết một chương trình khuyến mãi đã được xem trong danh sách.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Bỏ qua nếu thiết lập ở cấp mặt hàng.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng.
items	Array<Item>	Có*		Các mặt hàng cho sự kiện. * Mảng items dự kiến sẽ có một đại diện cho mặt hàng được liên kết với chương trình khuyến mãi. Nếu có nhiều đã được cung cấp, thì chỉ phần tử đầu tiên trong items sẽ để sử dụng.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
item_name	string	Có*	Áo phông Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu hiện tại.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo liên kết với mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu hiện tại.
discount	number	Không	2,22	Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index	number	Không	5	Chỉ mục/vị trí của mục trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Áo ngắn tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục.
price	number	Không	10,01	Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định . Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name	string	Không	Khuyến mại mùa hè	Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity	number	Không	3	Số lượng mặt hàng. Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: view_promotion
• Biến lớp dữ liệu (Tên - Tên biến lớp dữ liệu):
• Tên mẫu quảng cáo thương mại điện tử – ecommerce.creative_name
• Vị trí mẫu quảng cáo thương mại điện tử – ecommerce.creative_slot
• Mã khuyến mãi thương mại điện tử – ecommerce.promotion_id
• Tên chương trình khuyến mãi thương mại điện tử – ecommerce.promotion_name
• Mặt hàng thương mại điện tử – ecommerce.items
• Thông số sự kiện (Tên thông số – Giá trị):
• creative_name – {{Tên mẫu quảng cáo thương mại điện tử}}
• creative_slot – {{Vị trí quảng cáo thương mại điện tử}}
• promotion_id – {{Mã khuyến mãi thương mại điện tử}}
• promotion_name – {{Tên chương trình khuyến mãi thương mại điện tử}}
• items – {{Mặt hàng thương mại điện tử}}
• Điều kiện kích hoạt: sự kiện tương đương với view_promotion

Cấu hình điều kiện kích hoạt:

• Loại trình kích hoạt: Sự kiện tùy chỉnh
• Tên sự kiện: view_promotion
• Trình kích hoạt này kích hoạt trên: Tất cả các sự kiện tùy chỉnh

dataLayer.push({ ecommerce: null });  // Clear the previous ecommerce object.
dataLayer.push({
  event: "view_promotion",
  ecommerce: {
    creative_name: "Summer Banner",
    creative_slot: "featured_app_1",
    promotion_id: "P_12345",
    promotion_name: "Summer Sale",
    items: [
    {
      item_id: "SKU_12345",
      item_name: "Stan and Friends Tee",
      affiliation: "Google Merchandise Store",
      coupon: "SUMMER_FUN",
      discount: 2.22,
      index: 0,
      item_brand: "Google",
      item_category: "Apparel",
      item_category2: "Adult",
      item_category3: "Shirts",
      item_category4: "Crew",
      item_category5: "Short sleeve",
      item_list_id: "related_products",
      item_list_name: "Related Products",
      item_variant: "green",
      location_id: "ChIJIQBpAG2ahYAR_6128GcTUEo",
      price: 10.01,
      quantity: 3
    }
    ]
  }
});

working_lead

Sự kiện này đo lường thời điểm một người dùng liên hệ hoặc được một người đại diện liên hệ.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	USD	Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30,03	Giá trị bằng tiền của sự kiện. * value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value. * currency là bắt buộc nếu bạn đặt value.
lead_status	string	Không	Cuộc trò chuyện đã bắt đầu	Trạng thái của khách hàng tiềm năng.

Ví dụ:

Sau đây là ví dụ về cách triển khai Trình quản lý thẻ:

Hiển thị cấu hình thẻ cho tôi

Cấu hình thẻ:

• Loại thẻ: Sự kiện GA4
• Tên sự kiện: working_lead
• Thông số sự kiện (Tên thông số – Giá trị):
• currency – USD
• value – 30,03
• lead_status - Cuộc trò chuyện đã bắt đầu
• Kích hoạt sự kiện khi người dùng liên hệ hoặc được liên hệ qua người đại diện