ad_impression
Hãy sử dụng sự kiện này khi người dùng nhìn thấy một lượt hiển thị quảng cáo.
ad_impression
được gửi bằng Measurement Protocol sẽ không được đưa vào dữ liệu xuất sang các nền tảng quảng cáo khác, chẳng hạn như Google Ads.- Việc gửi các sự kiện
ad_impression
bằng Measurement Protocol có thể gây ra lượt hiển thị trùng lặp nếu bạn đã định cấu hình tính năng gắn thẻ hoặc SDK cho các sản phẩm quảng cáo của Google được liên kết. Chỉ gửi một sự kiệnad_impression
bằng Measurement Protocol nếu sự kiện đó không được ghi lại bằng tính năng gắn thẻ hoặc SDK.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
ad_platform |
string |
Không | MoPub | Nền tảng quảng cáo. |
ad_source |
string |
Không | AdColony | Nguồn quảng cáo. |
ad_format |
string |
Không | Biểu ngữ | Định dạng quảng cáo. |
ad_unit_name |
string |
Không | Banner_03 | Tên đơn vị quảng cáo. |
currency |
string |
Không | 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 |
Không | euro | Giá trị của lượt hiển thị quảng cáo. * value thường là bắt buộc để có báo cáo hữu ích.
* currency là bắt buộc nếu bạn đặt value .
|
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"ad_impression",
"params":{
"ad_platform": "MoPub",
"ad_source": "AdColony",
"ad_format": "Banner",
"ad_unit_name": "Banner_03",
"currency": "USD",
"value": 3.99
}
}]
})
});
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ử.
Thông 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_payment_info",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"payment_type": "Credit Card",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_shipping_info
Sự kiện này cho 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ử.
Thông 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_shipping_info",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping_tier": "Ground",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_to_cart
Sự kiện này cho biết rằng một mặt hàng đã được thêm vào giỏ hàng để mua.
Thông 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_cart",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
add_to_wishlist
Sự kiện này cho biết rằng một mặt hàng đã được thêm vào danh sách yêu thích. 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.
Thông 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "add_to_wishlist",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
begin_checkout
Sự kiện này cho biết một người dùng đã bắt đầu một quy trình thanh toán.
Thông 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "begin_checkout",
"params": {
"currency": "USD",
"value": 30.03,
"coupon": "SUMMER_FUN",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
campaign_details
Hãy sử dụng sự kiện này để gửi thông tin chi tiết về chiến dịch sẽ được áp dụng cho các sự kiện trong tương lai.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
campaign_id |
string |
Không | google_1234 | Mã chiến dịch. |
campaign |
string |
Không | Summer_fun | Tên dùng để xác định một quảng cáo cụ thể hoặc chiến dịch mang tính chiến lược cụ thể. |
source |
string |
Không | Nguồn lưu lượng truy cập của chiến dịch (ví dụ: google, email, v.v.). | |
medium |
string |
Không | cpc | Phương tiện chiến dịch (ví dụ: email, chi phí mỗi lượt nhấp, v.v.) |
term |
string |
Không | summer+travel | Cụm từ chiến dịch được sử dụng cùng với kết quả tìm kiếm có trả phí để cung cấp từ khoá cho quảng cáo. |
content |
string |
Không | logolink | Nội dung chiến dịch được sử dụng cho thử nghiệm A/B và quảng cáo nhắm mục tiêu theo nội dung để phân biệt các quảng cáo hoặc liên kết trỏ đến cùng một URL. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "campaign_details",
"params": {
"campaign_id": "google_1234",
"campaign": "Summer_fun",
"source": "google",
"medium": "cpc",
"term": "summer+travel",
"content": "logolink"
}
}]
})
});
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.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung 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. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "earn_virtual_currency",
"params": {
"virtual_currency_name": "Gems",
"value": 5
}
}]
})
});
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ọ.
Thông 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 .
|
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "generate_lead",
"params": {
"currency": "USD",
"value": 99.99
}
}]
})
});
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.
Thông 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. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events":[{
"name":"join_group",
"params":{
"group_id":"G_12345"
}
}]
})
});
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.
Thông 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. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "level_up",
"params": {
"level": 5,
"character": "Player 1"
}
}]
})
});
đă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.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
method |
string |
Không | Phương thức được dùng để đăng nhập. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "login",
"params": {
"method": "Google"
}
}]
})
});
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.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
score |
number |
Có | 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. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "post_score",
"params": {
"score": 10000,
"level": 5,
"character": "Player 1"
}
}]
})
});
purchase
Sự kiện này cho biết thời điểm một người dùng mua một hoặc nhiều mặt hàng.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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 |
Có | 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "purchase",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
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.
Thông 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 |
Có | 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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "refund",
"params": {
"currency": "USD",
"transaction_id": "T_12345",
"value": 30.03,
"coupon": "SUMMER_FUN",
"shipping": 3.33,
"tax": 1.11,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
remove_from_cart
Sự kiện này cho biết rằng một mặt hàng đã bị xoá khỏi giỏ hàng.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "remove_from_cart",
"params": {
"currency": "USD",
"value": 30.03,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
screen_view
Hãy dùng sự kiện này để biểu thị rằng quá trình chuyển đổi màn hình đã xảy ra.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
screen_class |
string |
Không | MainActivity | Lớp màn hình. |
screen_name |
string |
Không | Giới thiệu | Tên màn hình. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "screen_view",
"params": {
"screen_class": "MainActivity",
"screen_name": "About"
}
}]
})
});
tìm-kiếm
Ghi lại sự kiện này để cho biết thời điểm người dùng đã thực hiện 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.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
search_term |
string |
Có | áo thun | Cụm từ được tìm kiếm. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "search",
"params": {
"search_term": "t-shirts"
}
}]
})
});
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.
Thông 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. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_content",
"params": {
"content_type": "product",
"content_id": "C_12345"
}
}]
})
});
select_item
Sự kiện này biểu thị một mặt hàng đã được chọn trong danh sách.
Thông 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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_item",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
select_promotion
Sự kiện này cho biết một chương trình khuyến mãi đã được chọn trong danh sách.
Thông 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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "select_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
chia sẻ
Sử dụng sự kiện này khi người dùng đã chia sẻ nội dung.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
method |
string |
Không | 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ẻ. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "share",
"params": {
"method": "Twitter",
"content_type": "image",
"item_id": "C_12345"
}
}]
})
});
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.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
method |
string |
Không | Phương thức được dùng để đăng ký. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "sign_up",
"params": {
"method": "Google"
}
}]
})
});
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.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
value |
number |
Có | 5 | Giá trị của đơn vị tiền tệ ảo. |
virtual_currency_name |
string |
Có | Gem | Tên đơn vị tiền tệ ảo. |
item_name |
string |
Không | Tăng cường ban đầu | Tên của mặt hàng đang sử dụng tiền ảo. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "spend_virtual_currency",
"params": {
"value": 5,
"virtual_currency_name": "Gems",
"item_name": "Starter Boost"
}
}]
})
});
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.
Thông số
Không có thông số nào được đề xuất cho sự kiện này.
Không có thông số cho sự kiện này.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_begin"
}]
})
});
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.
Thông số
Không có thông số nào được đề xuất cho sự kiện này.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "tutorial_complete"
}]
})
});
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.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
achievement_id |
string |
Có | A_12345 | Mã của thành tích đã được mở khoá. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "unlock_achievement",
"params": {
"achievement_id": "A_12345"
}
}]
})
});
view_cart
Sự kiện này cho biết người dùng đã xem giỏ hàng của họ.
Thông 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_cart",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
view_item
Sự kiện này cho 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.
Thông 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á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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item",
"params": {
"currency": "USD",
"value": 7.77,
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
],
}
}]
})
});
view_item_list
Ghi lại sự kiện này khi người dùng thấy danh sách các mặt hàng thuộc một danh mục nhất định.
Thông 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. |
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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_item_list",
"params": {
"item_list_id": "related_products",
"item_list_name": "Related products",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"quantity": 3
}
]
}
}]
})
});
view_promotion
Sự kiện này cho biết một chương trình khuyến mãi đã được xem trong danh sách.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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_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ị |
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 | 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. |
items
.
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_promotion",
"params": {
"creative_name": "Summer Banner",
"creative_slot": "featured_app_1",
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"items": [
{
"item_id": "SKU_12345",
"item_name": "Stan and Friends Tee",
"affiliation": "Google Merchandise Store",
"coupon": "SUMMER_FUN",
"creative_name": "summer_banner2",
"creative_slot": "featured_app_1",
"currency": "USD",
"discount": 2.22,
"index": 0,
"item_brand": "Google",
"item_category": "Apparel",
"item_category2": "Adult",
"item_category3": "Shirts",
"item_category4": "Crew",
"item_category5": "Short sleeve",
"item_list_id": "related_products",
"item_list_name": "Related Products",
"item_variant": "green",
"location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
"price": 10.01,
"promotion_id": "P_12345",
"promotion_name": "Summer Sale",
"quantity": 3
}
]
}
}]
})
});
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.
Thông 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. |
Gửi sự kiện
Dùng thử sự kiện này trong Trình tạo sự kiện GA4
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "view_search_results",
"params": {
"search_term": "Clothing"
}
}]
})
});