Tài liệu tham khảo về sự kiện

Tài liệu tham khảo này liệt kê các sự kiện được đề xuất mà các thẻ Google hỗ trợ.

add_payment_info

Sự kiện này cho biế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ử.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt 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 độc lập với nhau.
payment_type string Không Thẻ tín dụng Phương thức thanh toán đã chọn.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

add_shipping_info

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

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt 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 độc lập với nhau.
shipping_tier string Không Đường bộ 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 mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

add_to_cart

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

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

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. Hãy sử dụng sự kiện này để xác định các mặt hàng quà tặng phổ biến trong ứng dụng của bạn.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

begin_checkout

Sự kiện này cho biết một người dùng đã bắt đầu một quy trình thanh toán.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt 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 độc lập với nhau.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

earn_virtual_currency

Sự kiện này đo lường thời điểm người dùng được tặng tiền ảo trong một trò chơi. Hãy ghi lại thông tin này cùng với spend_virtual_currency để hiểu rõ hơn về nền kinh tế ảo của bạn.

Tham số

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

trường hợp ngoại lệ

Một sự kiện ngoại lệ được ghi lại khi quy trình thực thi thông thường của một ứng dụng bị gián đoạn.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
description string Không Thiếu trường bắt buộc. Nội dung mô tả về trường hợp ngoại lệ đã xảy ra.
fatal boolean Không true Liệu ngoại lệ này có nghiêm trọng hay không.

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 để biết được mức độ hiệu quả của các chiến dịch tiếp thị và số lượng khách hàng tương tác lại với doanh nghiệp của bạn sau khi tái tiếp thị cho họ.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.

join_group

Ghi lại sự kiện này khi người dùng tham gia một nhóm, chẳng hạn như bang hội, nhóm hoặc gia đình. Hãy 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 mạng xã hội nhất định.

Tham số

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

level_end

Sự kiện này cho biết người chơi đã đạt đến cuối một cấp độ của trò chơi.

Tham số

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

level_start

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

Tham số

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

level_up

Sự kiện này cho biết một người chơi đã lên cấp trong một trò chơi. Hãy sử dụng chỉ số này để đánh giá mức phân bổ cấp độ cơ sở người dùng và xác định các cấp khó hoàn thành.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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.

đăng nhập

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

Tham số

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

page_view

Sự kiện này cho biết người dùng đã xem một trang.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
page_location string Không https://example.com URL của trang.
client_id string Không ABC_123 Mã ứng dụng khách.
language string Không en_us Ngôn ngữ dành cho khách hàng. Xem bài viết Thẻ và mã ngôn ngữ.
page_encoding string Không UTF-8 Phương thức mã hoá của trang.
page_title string Không Trang chủ Tiêu đề của trang.
user_agent string Không Tác nhân người dùng của khách hàng.

post_score

Gửi sự kiện này khi người dùng đăng một điểm số. Hãy sử dụng sự kiện này để tìm hiểu hiệu suất của người dùng trong trò chơi và liên hệ điểm số cao với đối tượng hoặc hành vi.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
score number 10000 Điểm số để đăng.
level number Không 5 Cấp độ của điểm số.
character string Không Người chơi 1 Nhân vật đã đạt được điểm số này.

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.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
transaction_id string T_12345 Mã 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 nhận được 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 độc lập với nhau.
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 mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

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.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có currency để tính toán chính xác chỉ số doanh thu.
transaction_id string T_12345 Mã 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt 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 độc lập với nhau.
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 của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

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.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

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

Tham số

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

select_content

Sự kiện này cho biết 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 và danh mục nội dung phổ biến trên trang web hoặc ứng dụng của mình.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
content_type string Không product 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.

select_item

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

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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ị bỏ qua nếu đặt ở 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ị bỏ qua nếu đặt ở cấp mặt hàng.
items Array<Item> Có* Các mặt hàng của sự kiện.

* Mảng items dự kiến phải có một phần tử duy nhất, đại diện cho mục đã chọn. Nếu bạn cung cấp nhiều phần tử, thì 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 Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

select_promotion

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

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Bị bỏ qua nếu đặt ở 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 được liên kết với sự kiện.

Bị bỏ qua nếu đặt ở cấp mặt hàng.
promotion_id string Không P_12345 Mã của chương trình khuyến mãi liên kết với sự kiện.

Bị bỏ qua nếu đặt ở 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 quan đến sự kiện.

Bị bỏ qua nếu đặt ở cấp mặt hàng.
items Array<Item> Không Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

chia sẻ

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

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
method string Không Twitter Phương thức mà nội dung được chia sẻ.
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ẻ.

sign_up

Sự kiện này cho biết 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à đăng xuất.

Tham số

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

spend_virtual_currency

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

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
value number 5 Giá trị của đơn vị tiền tệ ảo.
virtual_currency_name string Địa điểm thú vị Tên đơn vị tiền tệ ảo.
item_name string Không Tăng cường ban đầu Tên của mặt hàng đang sử dụng tiền ảo.

tutorial_begin

Sự kiện này cho biết thời điểm bắt đầu quy trình tham gia. Hãy sử dụng phần này trong phễu có tutorial_complete để biết có bao nhiêu người dùng hoàn thành hướng dẫn.

Tham số

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

tutorial_complete

Sự kiện này cho biết người dùng đã hoàn tất quy trình tham gia của bạn. Hãy sử dụng phần này trong phễu có tutorial_begin để biết có bao nhiêu người dùng hoàn thành hướng dẫn.

Tham số

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

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 người dùng đang trải nghiệm trò chơi của bạn như thế nào.

Tham số

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

view_cart

Sự kiện này cho biết người dùng đã xem giỏ hàng của họ.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

view_item

Sự kiện này cho biết rằng người dùng đã nhìn thấy một số nội dung. Hãy sử dụng sự kiện này để khám phá các mặt hàng phổ biến nhất được xem.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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 định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì cần có 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 đánh dấu sự kiện là lượt chuyển đổi thì bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

view_item_list

Ghi lại sự kiện này khi người dùng thấy danh sách các mặt hàng thuộc một danh mục nhất định.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung 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ị bỏ qua nếu đặt ở 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ị bỏ qua nếu đặt ở cấp mặt hàng.
items Array<Item> Các mặt hàng của sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

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.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Bị bỏ qua nếu đặt ở 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 được liên kết với sự kiện.

Bị bỏ qua nếu đặt ở cấp mặt hàng.
promotion_id string Không P_12345 Mã của chương trình khuyến mãi liên kết với sự kiện.

Bị bỏ qua nếu đặt ở 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 quan đến sự kiện.

Bị bỏ qua nếu đặt ở cấp mặt hàng.
items Array<Item> Có* Các mặt hàng của sự kiện.

* Mảng items dự kiến sẽ có một phần tử duy nhất, đại diện cho mặt hàng liên kết với chương trình khuyến mãi. Nếu bạn cung cấp nhiều phần tử, thì 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 Nội dung mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải nhậ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 nhập một trong hai giá trị item_id hoặc item_name.

affiliation string Không Google Store Một đơn vị liên kết sản phẩm để xác định công ty cung cấp hoặc vị trí cửa hàng thực.
Lưu ý: API "affiliation" chỉ có ở phạm vi mặt hàng.
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 độc lập với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu bạn đặt chính sách này, thì creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng creative_slot cấp sự kiện (nếu có).
discount number Không 2,22 Giá trị chiết khấu bằng tiền theo đơn vị tiền tệ 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 hệ thống phân cấp hoặc phân loại danh mục thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ phân cấp danh mục thứ hai hoặc phân loại bổ sung cho mặt hàng.
item_category3 string Không Áo Hệ phân cấp danh mục thứ ba hoặc phân loại bổ sung cho mặt hàng.
item_category4 string Không Nhóm sản xuất Hệ phân cấp danh mục thứ tư hoặc phân loại bổ sung cho mặt hàng.
item_category5 string Không Tay ngắn Thứ bậc danh mục thứ năm hoặc phân loại bổ sung cho 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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_id cấp sự kiện (nếu có).
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 bạn đặt chính sách này, thì 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, thì hệ thống sẽ sử dụng item_list_name cấp sự kiện (nếu có).
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 để cung cấp thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (ID địa điểm trên Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm trên Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: Thuộc tính "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá tiền tệ của mặt hàng, tính bằng đơn vị của thông số đơn vị tiền tệ đã chỉ định.
Nếu áp dụng chiết khấu cho mặt hàng, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong tham số discount.
promotion_id string Không P_12345 Mã chương trình khuyến mãi liên kết với mặt hàng.

Nếu bạn đặt chính sách này, thì promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
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ếu bạn đặt chính sách này, thì promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì hệ thống sẽ sử dụng promotion_name cấp sự kiện (nếu có).
quantity number Không 3

Số lượng mặt hàng.

Nếu không đặt, quantity sẽ được đặt thành 1.

Ngoài các tham số quy định, bạn có thể đưa vào tối đa 27 thông số tuỳ chỉnh trong mảng items.

view_search_results

Ghi lại sự kiện này khi người dùng thấy kết quả tìm kiếm. Xin lưu ý rằng bạn có thể bật sự kiện view_search_results để tự động thu thập thông qua tính năng đo lường sự kiện nâng cao trong Google Analytics.

Tham số

Tên Loại Bắt buộc Giá trị mẫu Nội dung mô tả
search_term string Không Quần áo Cụm từ được dùng để tìm kiếm.