ad_impression
Sử dụng sự kiện này khi người dùng 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 các 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 cách 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ì bắt buộc phải 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
Hãy 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ì bắt buộc phải 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, 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 là
độc lập với nhau.
|
payment_type |
string |
Không | Thẻ tín dụng | Phương thức thanh toán đã chọn. |
items |
Array<Item> |
Có | Các mặt hàng cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 vận chuyể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ì bắt buộc phải 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, 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 là
độ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 cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 một mặt hàng đã được thêm vào giỏ hàng để mua hàng.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, 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 cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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ón quà phổ biến trong ứng dụng của bạn.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, 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 cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 biểu thị rằng người dùng đã bắt đầu quy trình thanh toán.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, 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 là
độc lập với nhau.
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 được sử dụng để xác định quảng cáo hoặc chiến dịch 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 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 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 đường liên kết trỏ đến cùng một URL. |
Gửi sự kiện
Hãy 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"
}
}]
})
});
close_convert_lead
Sự kiện này đo lường thời điểm một khách hàng tiềm năng đã được chuyển đổi và kết thúc (ví dụ: thông qua giao dịch mua 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ì bắt buộc phải 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, bạn nên đặt value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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": "close_convert_lead",
"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
}
]
}
}]
})
});
close_unconvert_lead
Sự kiện này đo lường thời điểm một người dùng được đánh dấu là chưa trở thành khách hàng tiềm năng đã chuyển đổi, kèm theo lý do.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, bạn nên đặt value .
* currency là bắt buộc nếu bạn đặt value .
|
unconvert_lead_reason |
string |
Không | Chưa từng trả lời | Lý do khiến khách hàng tiềm năng không được chuyển đổi. |
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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": "close_unconvert_lead",
"params": {
"currency": "USD",
"value": 30.03,
"unconvert_lead_reason": "Never responded",
"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
}
]
}
}]
})
});
disqualify_lead
Sự kiện này đo lường thời điểm một người dùng được đánh dấu là không đủ điều kiện để trở thành khách hàng tiềm năng, cùng với lý do không đủ điều kiện.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, bạn nên đặt value .
* currency là bắt buộc nếu bạn đặt value .
|
disqualified_lead_reason |
string |
Không | Không muốn mua | Lý do mà một khách hàng tiềm năng được đánh dấu là không đủ tiêu chuẩn. |
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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": "disqualify_lead",
"params": {
"currency": "USD",
"value": 30.03,
"disqualified_lead_reason": "Not looking to buy",
"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
}
]
}
}]
})
});
earn_virtual_currency
Sự kiện này đo lường thời điểm người dùng được thưởng tiền ảo trong một trò chơi. Hãy ghi nhật ký này cùng với spend_virtual_currency để hiểu rõ hơn về nền kinh tế ảo.
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
Hãy 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). Hãy ghi lại thông tin này để tìm hiểu 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 khách 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ì bắt buộc phải 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, bạn nên đặt value .
* currency là bắt buộc nếu bạn đặt value .
|
lead_source |
string |
Không | Triển lãm thương mại | Nguồn của khách hàng tiềm năng. |
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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": 30.03,
"lead_source": "Trade show",
"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
}
]
}
}]
})
});
join_group
Ghi lại sự kiện này khi người dùng tham gia một nhóm như bang hội, nhóm hoặc gia đình. 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
Hãy 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 báo hiệu rằng một người chơi đã lên cấp trong 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
Hãy 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 để báo hiệu rằng một người dùng đã đăng nhập vào trang web hoặc ứng dụng của bạn.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
method |
string |
Không | Phương thức dùng để đăng nhập. |
Gửi sự kiện
Hãy 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 điểm số. Hãy sử dụng sự kiện này để nắm được hiệu suất của người dùng trong trò chơi của bạn và liên hệ điểm 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 | Tỷ số cần đăng. |
level |
number |
Không | 5 | Cấp độ cho điểm số. |
character |
string |
Không | Người chơi 1 | Nhân vật đã ghi điểm số. |
Gửi sự kiện
Hãy 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ì bắt buộc phải 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, bạn nên đặt value .
* currency là bắt buộc nếu bạn đặt value .
|
transaction_id |
string |
Có | T_12345 | Giá trị nhận dạng riêng biệt của một giao dịch. Thông số transaction_id giúp bạn tránh lấy các sự kiện trùng lặp cho một giao dịch mua hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập 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 cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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
}
]
}
}]
})
});
qualify_lead
Sự kiện này đo lường thời điểm một người dùng được đánh dấu là đáp ứng các tiêu chí để trở thành khách hàng tiềm năng đủ tiêu chuẩn.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, bạn nên đặt value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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": "qualify_lead",
"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
}
]
}
}]
})
});
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ì bắt buộc phải có currency
để tính toán chính xác chỉ số doanh thu.
|
transaction_id |
string |
Có | T_12345 | Giá trị nhận dạng riêng biệt của một giao dịch. |
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu đánh dấu sự kiện đó là lượt chuyển đổi, 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 là
độc lập với nhau.
|
shipping |
number |
Không | 3,33 | Phí vận chuyển liên quan đến một giao dịch. |
tax |
number |
Không | 1,11 | Chi phí thuế liên quan đến một giao dịch. |
items |
Array<Item>
|
Không* | Các mặt hàng cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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ì bắt buộc phải 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, 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 cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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
Sử dụng sự kiện này để biểu thị một lượt chuyển 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
Hãy 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 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 một trang kết quả tìm kiếm sau khi thực hiện một lượt 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 phông | Cụm từ được tìm kiếm. |
Gửi sự kiện
Hãy 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 thấy người dùng đã chọn một số nội dung thuộc một loại nhất định. Sự kiện này có thể giúp bạn xác định nội dung và các 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
Hãy 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ục đã được chọn từ 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ỏ qua nếu thiết lập ở cấp mặt hàng. |
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item> |
Có* | Các mặt hàng cho sự kiện. * Mảng items dự kiến sẽ có một 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 biểu thị một chương trình khuyến mãi đã được chọn từ danh sách.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo được liên kết với
sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 chia sẻ nội dung. | |
content_type |
string |
Không | hình ảnh | Loại nội dung được chia sẻ. |
item_id |
string |
Không | C_12345 | Mã của nội dung được chia sẻ. |
Gửi sự kiện
Hãy 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 rằng người dùng đã đăng ký tài khoản. Sử dụng sự kiện này để tìm hiểu các hành vi khác nhau của người dùng đã đăng nhập và đã đă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 dùng để đăng ký. |
Gửi sự kiện
Hãy 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 hoạt động bán hàng hoá ảo trong ứng dụng của bạn và giúp bạn xác định những hàng hoá ảo nà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 khởi đầu | Tên của mặt hàng mà đơn vị tiền tệ ảo đang được sử dụng. |
Gửi sự kiện
Hãy 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 biểu thị việc bắt đầu quy trình giới thiệu. Hãy sử dụng chỉ số này trong một phễu bằng tutorial_complete để biết số 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ố nào cho sự kiện này.
Gửi sự kiện
Hãy 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 giới thiệu. Hãy sử dụng chỉ số này trong phễu có tutorial_begin để biết số 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
Hãy 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
Hãy 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 thấy rằng một người dùng đã xem giỏ hàng.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, 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 cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 thấy rằng một số nội dung đã được hiển thị cho người dùng. Hãy sử dụng sự kiện này để khám phá những 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ì bắt buộc phải 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, 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 cho 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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ục 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ỏ qua nếu thiết lập ở cấp mặt hàng. |
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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ỏ qua nếu thiết lập ở cấp mặt hàng. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo được liên kết với
sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item> |
Có* | Các mặt hàng cho sự kiện. * Mảng items cần có một phần tử duy nhất, đại diện cho mặt hàng được liên kết với chương trình khuyến mãi. Nếu bạn cung cấp nhiều phần tử, thì chỉ 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 cung cấ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 cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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 được hiển thị kết quả tìm kiếm. Xin lưu ý rằng bạn có thể bật sự kiện view_search_results để thu thập tự động 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
Hãy 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"
}
}]
})
});
working_lead
Sự kiện này đo lường thời điểm một người dùng liên hệ hoặc được một người đại diện liên hệ.
Thông số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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ì bắt buộc phải 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, bạn nên đặt value .
* currency là bắt buộc nếu bạn đặt value .
|
lead_status |
string |
Không | Cuộc trò chuyện đã bắt đầu | Trạng thái của khách hàng tiềm năng. |
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Nội dung mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_name |
string |
Có* | Áo phông Stan and Friends |
Tên mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
affiliation |
string |
Không | Google Store |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực. Lưu ý: Thuộc tính "affiliation" chỉ áp dụng ở phạm vi mặt hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là
độc lập với nhau.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_name cấp sự kiện sẽ được sử dụng (nếu có). |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với
mặt hàng. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì creative_slot cấp sự kiện sẽ được sử dụng (nếu có). |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được 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ệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_id cấp sự kiện sẽ được sử dụng (nếu có).
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì item_list_name cấp sự kiện sẽ được sử dụng (nếu có).
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của 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 ý: "location id" (mã vị trí) chỉ có ở phạm vi mặt hàng. |
price |
number |
Không | 10,01 |
Đơn giá 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 mặt hàng có một khoản chiết khấu, hãy đặt price thành đơn giá chiết khấu rồi chỉ định mức chiết khấu theo đơn giá trong tham số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_id cấp sự kiện sẽ được sử dụng (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ày. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, thì promotion_name cấp sự kiện sẽ được sử dụng (nếu có).
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy 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": "working_lead",
"params": {
"currency": "USD",
"value": 30.03,
"lead_status": "Started conversations",
"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
}
]
}
}]
})
});