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 bao gồm khi 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
ad_impression
sự kiện bằng Measurement Protocol có thể khiến lần hiển thị trùng lặp nếu bạn đã định cấu hình gắn thẻ hoặc SDK cho Sản phẩm quảng cáo của Google. Chỉ gửi 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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
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 của Google Analytics
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 thấy một người dùng đã gửi thông tin thanh toán trong quy trình thanh toán thương mại điện tử.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
payment_type |
string |
Không | Thẻ tín dụng | Phương thức thanh toán đã chọn. |
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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 thấy một người dùng đã gửi thông tin vận chuyển trong một quy trình thanh toán thương mại điện tử.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
shipping_tier |
string |
Không | Mặt đất |
Cấp vận chuyển (ví dụ: Ground , Air ,
Next-day ) được chọn để giao mặt hàng đã mua.
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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. 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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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 của Google Analytics
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à đã chốt (ví dụ: thông qua một giao dịch mua hàng).
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì 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 | 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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì 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 | 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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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ề kinh tế ảo.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
virtual_currency_name |
string |
Không | Gem | Tên đơn vị tiền tệ ảo. |
value |
number |
Không | 5 | Giá trị của đơn vị tiền tệ ảo. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
method: "POST",
body: JSON.stringify({
"client_id": "client_id",
"events": [{
"name": "earn_virtual_currency",
"params": {
"virtual_currency_name": "Gems",
"value": 5
}
}]
})
});
generate_lead
Sự kiện này đo lường thời điểm một khách hàng tiềm năng đã được tạo (ví dụ: thông qua một biểu mẫu). Ghi lại thông tin này để nắm được mức độ hiệu quả của các chiến dịch tiếp thị và có bao nhiêu khách hàng tương tác lại với doanh nghiệp của bạn sau khi tiếp thị lại khách hàng.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì 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 | 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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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. Sử dụng sự kiện này để phân tích mức độ phổ biến của một số nhóm hoặc tính năng xã hội nhất định.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
group_id |
string |
Không | G_12345 | Mã của nhóm. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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. Sử dụng báo cáo này để đánh giá cơ sở người dùng theo cấp và xác định các mức độ khó đã hoàn tất.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
level |
number |
Không | 5 | Cấp độ của nhân vật. |
character |
string |
Không | Người chơi 1 | Nhân vật đã lên cấp. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
method |
string |
Không | Phương thức dùng để đăng nhập. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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 để tìm hiểu đang hoạt động hiệu quả như thế nào trong trò chơi của bạn và tạo mối liên hệ giữa điểm số cao với đối tượng hoặc của Google.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
score |
number |
Có | 10000 | Tỷ số cần đăng. |
level |
number |
Không | 5 | Cấp độ cho điểm số. |
character |
string |
Không | Người chơi 1 | Nhân vật đã ghi điểm số. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ)
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
transaction_id |
string |
Có | T_12345 | Giá trị nhận dạng riêng biệt của một giao dịch. Thông số transaction_id giúp bạn tránh lấy các sự kiện trùng lặp cho một giao dịch mua hàng. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
shipping |
number |
Không | 3,33 | Phí vận chuyển liên quan đến một giao dịch. |
tax |
number |
Không | 1,11 | Chi phí thuế liên quan đến một giao dịch. |
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
transaction_id |
string |
Có | T_12345 | Giá trị nhận dạng riêng biệt của một giao dịch. |
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
shipping |
number |
Không | 3,33 | Phí vận chuyển liên quan đến một giao dịch. |
tax |
number |
Không | 1,11 | Chi phí thuế liên quan đến một giao dịch. |
items |
Array<Item>
|
Không* | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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 một mặt hàng đã bị xoá khỏi giỏ hàng.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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 của Google Analytics
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 người dùng đang tìm kiếm nội dung gì trên trang web hoặc ứng dụng của bạn. Để Ví dụ: bạn có thể gửi sự kiện này khi người dùng xem một trang kết quả tìm kiếm sau thực hiện tìm kiếm.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
search_term |
string |
Có | áo phông | Cụm từ được tìm kiếm. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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 phổ biến và các danh mục nội dung trên trang web hoặc ứng dụng của bạn.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
content_type |
string |
Không | sản phẩm | Loại nội dung đã chọn. |
content_id |
string |
Không | C_12345 | Giá trị nhận dạng cho nội dung đã chọn. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item> |
Có* | Các mặt hàng cho sự kiện. * Mảng items dự kiến sẽ có một
đại diện cho mục đã chọn. Nếu nhiều phần tử
được cung cấp, chỉ có phần tử đầu tiên trong items được sử dụng.
|
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item>
|
Không | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
method |
string |
Không | Phương thức chia sẻ nội dung. | |
content_type |
string |
Không | hình ảnh | Loại nội dung được chia sẻ. |
item_id |
string |
Không | C_12345 | Mã của nội dung được chia sẻ. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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à không đăng xuất.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
method |
string |
Không | Phương thức dùng để đăng ký. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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 loại hàng hoá ảo phổ biến nhất.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
value |
number |
Có | 5 | Giá trị của đơn vị tiền tệ ảo. |
virtual_currency_name |
string |
Có | Gem | Tên đơn vị tiền tệ ảo. |
item_name |
string |
Không | Tăng 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 của Google Analytics
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. Sử dụng báo cáo này trong một phễu bằng tutorial_complete để biết có bao nhiêu người dùng hoàn thành hướng dẫn.
Tham 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 của Google Analytics
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. Sử dụng bản thảo này trong phễu có tutorial_begin để biết có bao nhiêu người dùng hoàn tất của chúng tôi.
Tham 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 của Google Analytics
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ách người dùng trải nghiệm trò chơi của mình.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
achievement_id |
string |
Có | A_12345 | Mã của thành tích đã được mở khoá. |
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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. Sử dụng sự kiện này để khám phá những mặt hàng được xem nhiều nhất.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì bạn nên đặt
value .
* currency là bắt buộc nếu bạn đặt value .
|
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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 được xem danh sách các mục của danh mục nhất định.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item> |
Có | Các mặt hàng cho sự kiện. |
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với sự kiện. Bỏ qua nếu thiết lập ở cấp mặt hàng. |
items |
Array<Item> |
Có* | Các mặt hàng cho sự kiện. * Mảng items dự kiến sẽ có một
đại diện cho mặt hàng được liên kết với chương trình khuyến mãi. Nếu có nhiều
đã được cung cấp, thì chỉ phần tử đầu tiên trong items sẽ
để sử dụng.
|
Thông số mục
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
item_id |
string |
Có* | SKU_12345 |
Mã của mặt hàng.
*Bạn phải cung cấp một trong hai giá trị |
item_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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | 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 của Google Analytics
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ệ.
Tham số
Tên | Loại | Bắt buộc | Giá trị mẫu | Mô tả |
---|---|---|---|---|
currency |
string |
Có* | USD |
Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo
3 chữ cái
ISO 4217. * Nếu bạn đặt value thì bạn phải dùng currency
để tính toán chính xác chỉ số doanh thu.
|
value |
number |
Có* | 30,03 | Giá trị bằng tiền của sự kiện. * Đặt value thành tổng của (price * quantity) cho tất cả các mục trong
items . Đừng thêm shipping hoặc tax .
* value thường là bắt buộc để có báo cáo hữu ích.
Nếu bạn đánh dấu
sự kiện dưới dạng lượt chuyển đổi, thì 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 | 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 | Cửa hàng Google |
Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và
vị trí cửa hàng thực tế. Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục. |
coupon |
string |
Không | SUMMER_FUN | Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon cấp sự kiện và cấp mặt hàng là
độc lập.
|
creative_name |
string |
Không | summer_banner2 | Tên của mẫu quảng cáo. Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_name ở cấp sự kiện, nếu
hiện tại. |
creative_slot |
string |
Không | featured_app_1 | Tên của vùng mẫu quảng cáo liên kết với
mục. Nếu được đặt, creative_slot cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng creative_slot ở cấp sự kiện, nếu
hiện tại. |
discount |
number |
Không | 2,22 | Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này. |
index |
number |
Không | 5 | Chỉ mục/vị trí của mục trong danh sách. |
item_brand |
string |
Không | Thương hiệu của mặt hàng. | |
item_category |
string |
Không | Hàng may mặc | Danh mục của mặt hàng. Nếu được sử dụng như một phần của phân cấp danh mục hoặc thì đây sẽ là danh mục đầu tiên. |
item_category2 |
string |
Không | Người lớn | Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng. |
item_category3 |
string |
Không | Áo | Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng. |
item_category4 |
string |
Không | Nhóm sản xuất | Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng. |
item_category5 |
string |
Không | Áo ngắn tay | Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng. |
item_list_id |
string |
Không | related_products | Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_id ở cấp sự kiện, nếu
hiện tại.
|
item_list_name |
string |
Không | Sản phẩm có liên quan | Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng item_list_name ở cấp sự kiện, nếu
hiện tại.
|
item_variant |
string |
Không | xanh lục | Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tuỳ chọn. |
location_id |
string |
Không | ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) |
Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế
vị trí cửa hàng). Bạn nên sử dụng
Google
Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh
Mã nhận dạng cũng có thể được sử dụng. Lưu ý: "location id" (mã vị trí) chỉ có ở phạm vi mục. |
price |
number |
Không | 10,01 |
Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định
.
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và
chỉ định chiết khấu theo đơn giá trong thông số discount .
|
promotion_id |
string |
Không | P_12345 |
Mã của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ dùng promotion_id ở cấp sự kiện, nếu
hiện tại.
|
promotion_name |
string |
Không | Khuyến mại mùa hè |
Tên của chương trình khuyến mãi liên kết với mặt hàng này. Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu
hiện tại.
|
quantity |
number |
Không | 3 |
Số lượng mặt hàng. |
items
.
Gửi sự kiện
Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics
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
}
]
}
}]
})
});