Google Analytics tự động gửi một số loại sự kiện. Trang này mô tả các sự kiện bổ sung không bắt buộc mà bạn có thể định cấu hình để đo lường thêm nhiều hành vi và tạo báo cáo hữu ích hơn cho doanh nghiệp của mình. Bạn cần phải thiết lập thêm các sự kiện này thì mới có thể sử dụng chúng, vì vậy, Google Analytics 4 không thể tự động gửi các sự kiện này. Để biết hướng dẫn từng bước về cách định cấu hình sự kiện được đề xuất và sự kiện tuỳ chỉnh cho trang web hoặc ứng dụng của bạn, hãy xem bài viết Thiết lập sự kiện.
Để xem thông tin chi tiết về từng sự kiện mà bạn có thể sử dụng, hãy chọn nền tảng quản lý thẻ:
add_payment_info
Sự kiện này cho biết người dùng đã gửi thông tin thanh toán trong quá 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 | 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. Các chỉ số giá trị trên sự kiện view_item không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency 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 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á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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
add_shipping_info
Sự kiện này cho biết người dùng đã gửi thông tin vận chuyển trong quá 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 | 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. Các chỉ số giá trị trên sự kiện view_item sẽ không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency 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 với nhau.
|
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 của 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 |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
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 | 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. Các chỉ số giá trị trên sự kiện view_item không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
items |
Array<Item> |
Có | 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
add_to_wishlist
Sự kiện này cho biết 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ặ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 | 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. Các chỉ số giá trị trên sự kiện view_item sẽ không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
items |
Array<Item> |
Có | 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
begin_checkout
Sự kiện này cho biết rằng người dùng đã bắt đầu thanh toán.
Tham 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 định dạng ISO 4217 gồm 3 chữ cái. Các chỉ số giá trị trên sự kiện view_item không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency 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 với nhau.
|
items |
Array<Item> |
Có | 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
close_convert_lead
Sự kiện này đo lường thời điểm khách hàng tiềm năng được chuyển đổi và đóng (ví dụ: thông qua một giao dịch mua hàng).
Tham 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, ở đị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. * Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
Ví dụ:
close_unconvert_lead
Sự kiện này đo lường thời điểm người dùng được đánh dấu là không trở thành khách hàng tiềm năng đã chuyển đổi, cùng với lý do.
Tham 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, ở đị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. * Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
unconvert_lead_reason |
string |
Không | Chưa bao giờ trả lời | Lý do khách hàng tiềm năng không chuyển đổi. |
Ví dụ:
disqualify_lead
Sự kiện này đo lường thời điểm người dùng bị đá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 bị loại.
Tham 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, ở đị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. * Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
disqualified_lead_reason |
string |
Không | Không muốn mua | Lý do khách hàng tiềm năng bị đánh dấu là không đủ điều kiện. |
Ví dụ:
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 trò chơi. Ghi lại sự kiện 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 | 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ụ:
generate_lead
Sự kiện này đo lường thời điểm tạo khách hàng tiềm năng (ví dụ: thông qua một biểu mẫu). Hãy ghi lại thông tin này để hiểu đượ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 bạn tiếp thị lại cho họ.
Tham 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, ở đị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. * Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency 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ụ:
join_group
Ghi nhật ký sự kiện này khi người dùng tham gia một nhóm như hội đoàn, 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.
Tham 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ụ:
level_end
Sự kiện này cho biết người chơi đã đạt đến cuối một cấp trong trò chơi.
Tham 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ủa cấp độ. |
success |
boolean |
Không | đúng | Đặt thành true nếu bạn đã hoàn thành cấp độ thành công. |
Ví dụ:
level_start
Sự kiện này cho biết 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 | Mô tả |
|---|---|---|---|---|
level_name |
string |
Không | Hành trình bắt đầu... | Tên của cấp độ. |
Ví dụ:
level_up
Sự kiện này cho biết người chơi đã tăng cấp trong trò chơi. Hãy sử dụng chỉ số này để đánh giá mức độ phân phối cấp độ của cơ sở người dùng và xác định những cấp độ khó hoàn thành.
Tham 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ụ:
login
Gửi sự kiện này để cho biết rằng 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 | Mô tả |
|---|---|---|---|---|
method |
string |
Không | Phương thức dùng để đăng nhập. |
Ví dụ:
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 để hiểu rõ 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 | Mô tả |
|---|---|---|---|---|
score |
number |
Có | 10000 | Điểm số cần đăng. |
level |
number |
Không | 5 | Cấp độ cho điểm số. |
character |
string |
Không | Người chơi 1 | Ký tự đã đạt được điểm số. |
Ví dụ:
purchase
Sự kiện này cho biết thời điểm 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 | 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. Các chỉ số giá trị trên sự kiện view_item không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
transaction_id |
string |
Có | T_12345 | Giá trị nhận dạng duy nhất của một giao dịch. Thông số transaction_id giúp bạn tránh nhận 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 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á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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
qualify_lead
Sự kiện này đo lường thời điểm 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.
Tham 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, ở đị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. * Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
Ví dụ:
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 | 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. Các chỉ số giá trị trên sự kiện view_item không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác các chỉ số doanh thu.
|
transaction_id |
string |
Có | T_12345 | Giá trị nhận dạng duy nhấ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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency 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 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
remove_from_cart
Sự kiện này cho biết 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 | 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. Các chỉ số giá trị trên sự kiện view_item sẽ không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
items |
Array<Item> |
Có | 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
search
Ghi nhật ký 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 mà 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 một lượt tìm kiếm.
Tham số
| Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
|---|---|---|---|---|
search_term |
string |
Có | áo thun | Cụm từ được tìm kiếm. |
Ví dụ:
select_content
Sự kiện này cho biết rằng 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 | 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ụ:
select_item
Sự kiện này cho biết một mục đã được chọn từ danh sách.
Tham 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ị bỏ qua nếu được đặ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 được đặ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ục đã chọn. Nếu bạn cung cấp nhiều phần tử, thì chỉ phần tử đầu tiên trong items mới đượ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 |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
select_promotion
Sự kiện này cho biết một chương trình khuyến mãi đã được chọn từ danh sách.
Tham 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ị bỏ qua nếu được đặ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 được đặ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 được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng. |
promotion_name |
string |
Không | Giảm giá 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ị bỏ qua nếu được đặ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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độ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 được đặt, creative_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 được liên kết với mặt hàng. Nếu được đặt, creative_slot ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham 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, hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
|
promotion_name |
string |
Không | Giảm giá mùa hè |
Tên 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_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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. |
items.
Ví dụ:
share
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 | Mô tả |
|---|---|---|---|---|
method |
string |
Không | 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ụ:
sign_up
Sự kiện này cho biết rằng người dùng đã đăng ký một tài khoản. Sử dụng sự kiện này để 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 | Mô tả |
|---|---|---|---|---|
method |
string |
Không | Phương thức dùng để đăng ký. |
Ví dụ:
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 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 | 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 tốc khởi động | Tên của mặt hàng mà người dùng đang sử dụng tiền ảo. |
Ví dụ:
tutorial_begin
Sự kiện này đánh dấu sự bắt đầu của quy trình làm quen. Sử dụng chỉ số này trong phễu bằng 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ố nào cho sự kiện này.
Ví dụ:
tutorial_complete
Sự kiện này cho biết người dùng đã hoàn tất quy trình làm quen. Sử dụng thuộc tính này trong phễu có tutorial_begin để biết có bao nhiêu người dùng hoàn tất phần hướng dẫn.
Tham số
Không có thông số nào được đề xuất cho sự kiện này.
Ví dụ:
unlock_achievement
Ghi nhật ký sự kiện này khi người dùng đạt được một thành tích. Sự kiện này có thể giúp bạn hiểu được trải nghiệm của người dùng khi chơi trò chơi của bạn.
Tham 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ụ:
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 | 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. Các chỉ số giá trị trên sự kiện view_item không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
items |
Array<Item> |
Có | 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
view_item
Sự kiện này cho biết 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á các mặt hàng được xem phổ biến nhất.
Tham 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 định dạng ISO 4217 gồm 3 chữ cái. Các chỉ số giá trị trên sự kiện view_item sẽ không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác cá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. Không bao gồm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency nếu bạn đặt value.
|
items |
Array<Item> |
Có | 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
view_item_list
Ghi nhật ký sự kiện này khi người dùng được trình bày danh sách các mục thuộc một danh mục nhất định.
Tham 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 định dạng ISO 4217 gồm 3 chữ cái. Các chỉ số giá trị trên sự kiện view_item không đóng góp vào doanh thu* Nếu bạn đặt value thì cần có currency để tính toán chính xác các chỉ số doanh thu.
|
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 được đặ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 được đặt ở cấp mặt hàng. |
items |
Array<Item> |
Có | 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 | Mô tả |
|---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độc lập với nhau.
|
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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham số discount.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items.
Ví dụ:
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 | Mô tả |
|---|---|---|---|---|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Bị bỏ qua nếu được đặ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 được đặ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 được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng. |
promotion_name |
string |
Không | Giảm giá 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ị bỏ qua nếu được đặ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 được 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ỉ phần tử đầu tiên trong items mới đượ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 |
item_name |
string |
Có* | Áo thun Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp |
affiliation |
string |
Không | Cửa hàng Google |
Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "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 là độ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 được đặt, creative_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 được liên kết với mặt hàng. Nếu được đặt, creative_slot ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 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 | 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 dùng trong hệ phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Thứ bậc 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 | Thứ bậc 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 | Cộc 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, 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 được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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 để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của 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 của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh. Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Giá theo đơn vị tiền tệ của mặt hàng, tính theo đơn vị của tham số tiền tệ được chỉ định.
Nếu mặt hàng được chiết khấu, hãy đặt price thành giá chiết khấu theo đơn vị và chỉ định mức chiết khấu theo đơn vị trong tham 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, hệ thống sẽ sử dụng promotion_id cấp sự kiện (nếu có).
|
promotion_name |
string |
Không | Giảm giá mùa hè |
Tên 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_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, 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. |
items.
Ví dụ:
working_lead
Sự kiện này đo lường thời điểm người dùng liên hệ hoặc được nhân viên hỗ trợ liên hệ.
Tham 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, ở đị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. * Thông thường, bạn phải có value để có báo cáo hữu ích.
Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* Phải có currency 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. |