Sự kiện

Lưu ý quan trọng: Sử dụng app_instance_id thay vì client_id cho sự kiện Ứng dụng.

ad_impression

Sự kiện này chỉ dành cho luồng ứng dụng.

Hãy sử dụng sự kiện này khi người dùng nhìn thấy một lượt hiển thị quảng cáo.

• ad_impression được gửi bằng Measurement Protocol sẽ không được đưa vào các tệp xuất sang những nền tảng quảng cáo khác, chẳng hạn như Google Ads.
• Việc gửi sự kiện ad_impression bằng Measurement Protocol có thể gây ra lượt hiển thị trùng lặp nếu bạn đã định cấu hình tính năng gắn thẻ hoặc SDK cho các sản phẩm quảng cáo của Google được liên kết. Chỉ gửi sự kiện ad_impression bằng Measurement Protocol nếu sự kiện đó không được gắn thẻ hoặc SDK ghi lại.

Thông 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	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. * Nếu bạn đặt value thì currency là thông số bắt buộc để 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. * Thông thường, bạn cần có value để có báo cáo hữu ích. * Bạn phải có currency nếu đặt value.

Gửi sự kiện

Dùng 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({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

add_payment_info

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

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
payment_type	string	Không	Thẻ tín dụng	Phương thức thanh toán đã chọn.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 biết người dùng đã gửi thông tin vận chuyển trong quy trình thanh toán của trang thương mại điện tử.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
shipping_tier	string	Không	Mặt đất	Cấp vận chuyển (ví dụ: Ground, Air, Next-day) được chọn để giao mặt hàng đã mua.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 rằng một mặt hàng đã được thêm vào giỏ hàng để mua.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 một mặt hàng đã được thêm vào danh sách yêu thích. Sử dụng sự kiện này để xác định các mặt hàng quà tặng phổ biến trong ứng dụng của bạn.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 cho biết rằng người dùng đã bắt đầu quy trình thanh toán.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 dùng sự kiện này để gửi thông tin chi tiết về chiến dịch sẽ được áp dụng cho các sự kiện trong tương lai.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
campaign_id	string	Không	google_1234	Mã chiến dịch.
campaign	string	Không	Summer_fun	Tên dùng để xác định một chương trình khuyến mãi hoặc chiến dịch mang tính chiến lược cụ thể.
source	string	Không	google	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 của 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 dùng với quảng cáo 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 những quảng cáo hoặc đường liên kết trỏ đến cùng một URL.

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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à khép lại (ví dụ: thông qua một giao dịch mua hàng).

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái. * Nếu bạn đặt value thì currency là thông số bắt buộc để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30.03	Giá trị bằng tiền của sự kiện. * Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.

Gửi sự kiện

Dùng 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
      }
    }]
  })
});

close_unconvert_lead

Sự kiện này đo lường thời điểm người dùng được đánh dấu là không trở thành khách hàng tiềm năng đã chuyển đổi, cùng với lý do.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái. * Nếu bạn đặt value thì currency là thông số bắt buộc để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30.03	Giá trị bằng tiền của sự kiện. * Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
unconvert_lead_reason	string	Không	Chưa bao giờ phản hồi	Lý do khách hàng tiềm năng không chuyển đổi.

Gửi sự kiện

Dùng 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"
      }
    }]
  })
});

disqualify_lead

Sự kiện này đo lường thời điểm người dùng được đánh dấu là không đủ tiêu chuẩn để trở thành khách hàng tiềm năng, cùng với lý do không đủ tiêu chuẩn.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái. * Nếu bạn đặt value thì currency là thông số bắt buộc để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30.03	Giá trị bằng tiền của sự kiện. * Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
disqualified_lead_reason	string	Không	Không có ý định mua	Lý do khách hàng tiềm năng bị đánh dấu là không đủ tiêu chuẩn.

Gửi sự kiện

Dùng 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"
      }
    }]
  })
});

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. Ghi nhật ký sự kiện này cùng với spend_virtual_currency để hiểu rõ hơn về nền kinh tế ảo của bạn.

Thông 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

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

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái. * Nếu bạn đặt value thì currency là thông số bắt buộc để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30.03	Giá trị bằng tiền của sự kiện. * Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặ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.

Gửi sự kiện

Dùng 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"
      }
    }]
  })
});

join_group

Ghi nhật ký sự kiện này khi người dùng tham gia một nhóm như hội đoàn, nhóm hoặc gia đình. Sử dụng sự kiện này để phân tích mức độ phổ biến của một số nhóm hoặc tính năng xã hội nhất định.

Thông số

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

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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 cho biết người chơi đã lên cấp trong một trò chơi. Hãy dùng thông tin này để đánh giá mức độ phân bổ của cơ sở người dùng và xác định những cấp độ khó hoàn thành.

Thông 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

Dùng 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"
      }
    }]
  })
});

login

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

Thông số

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

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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 để biết hiệu suất của người dùng trong trò chơi và tương quan điểm số cao với đối tượng hoặc hành vi.

Thông số

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

Gửi sự kiện

Dùng 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 người dùng mua một hoặc nhiều mặt hàng.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
transaction_id	string	Có	T_12345	Giá trị nhận dạng riêng biệt của một giao dịch. Thông số transaction_id giúp bạn tránh lấy các sự kiện trùng lặp cho một giao dịch mua hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
shipping	number	Không	3,33	Phí vận chuyển liên quan đến một giao dịch.
tax	number	Không	1,11	Chi phí thuế liên quan đến một giao dịch.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 người dùng được đánh dấu là đáp ứng tiêu chí để trở thành khách hàng tiềm năng đủ tiêu chuẩn.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái. * Nếu bạn đặt value thì currency là thông số bắt buộc để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30.03	Giá trị bằng tiền của sự kiện. * Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.

Gửi sự kiện

Dùng 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
      }
    }]
  })
});

refund

Sự kiện này cho biết thời điểm người dùng được hoàn tiền cho một hoặc nhiều mặt hàng.

Lưu ý: Bạn nên thêm thông tin về mặt hàng vào sự kiện refund để xem các chỉ số hoàn tiền ở cấp mặt hàng trong Analytics.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với sự kiện. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
shipping	number	Không	3,33	Phí vận chuyển liên quan đến một giao dịch.
tax	number	Không	1,11	Chi phí thuế liên quan đến một giao dịch.
items	Array<Item>	Không*		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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ự kiện này chỉ dành cho luồng ứng dụng.

Sử dụng sự kiện này để biểu thị rằng đã xảy ra một quá trình chuyển đổi màn hình.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
screen_class	string	Không	MainActivity	Loại màn hình.
screen_name	string	Không	Giới thiệu	Tên màn hình.

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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({
    "app_instance_id": "app_instance_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

search

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

Thông số

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

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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 biết rằng người dùng đã chọn một số nội dung thuộc một loại nhất định. Sự kiện này có thể giúp bạn xác định nội dung và danh mục nội dung phổ biến trên trang web hoặc ứng dụng của mình.

Thông 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

Dùng 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 cho biết một mục đã được chọn trong danh sách.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
items	Array<Item>	Có*		Các mặt hàng của sự kiện. * Mảng items dự kiến sẽ có một phần tử duy nhất, đại diện cho mục đã chọn. Nếu bạn cung cấp nhiều phần tử, thì chỉ phần tử đầu tiên trong items sẽ được sử dụng.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 cho biết một chương trình khuyến mãi đã được chọn trong danh sách.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo khuyến mãi. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
promotion_name	string	Không	Giảm giá mùa hè	Tên của chương trình khuyến mãi được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
items	Array<Item>	Không		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo khuyến mãi. Nếu được đặt, creative_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng creative_name ở cấp sự kiện (nếu có).
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo được liên kết với mặt hàng. Nếu được đặt, creative_slot ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng creative_slot ở cấp sự kiện (nếu có).
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
promotion_id	string	Không	P_12345	Mã nhận dạng của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng promotion_id ở cấp sự kiện (nếu có).
promotion_name	string	Không	Giảm giá mùa hè	Tên của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện (nếu có).
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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
          }
        ]
      }
    }]
  })
});

share

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

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
method	string	Không	Twitter	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ã nhận dạng của nội dung được chia sẻ.

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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 người dùng đã đăng ký tài khoản. Sử dụng sự kiện này để hiểu các hành vi khác nhau của người dùng đã đăng nhập và đăng xuất.

Thông số

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

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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 việc bán hàng hoá ảo trong ứng dụng của bạn và giúp bạn xác định những hàng hoá ảo phổ biến nhất.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	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	Starter Boost	Tên của mặt hàng mà đơn vị tiền tệ ảo đang được dùng.

Gửi sự kiện

Dùng 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 đánh dấu sự bắt đầu của quy trình tham gia. Sử dụng sự kiện này trong một phễu cùng với tutorial_complete để biết có bao nhiêu người dùng hoàn thành hướng dẫn.

Thông số

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

Sự kiện này không có thông số.

Gửi sự kiện

Dùng 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 tham gia của bạn. Sử dụng tham số này trong một phễu có tutorial_begin để biết số lượng người dùng hoàn tất hướng dẫn.

Thông số

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

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện 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 nhật ký sự kiện này khi người dùng đạt được một thành tích. Sự kiện này có thể giúp bạn nắm được trải nghiệm của người dùng về trò chơi của bạn.

Thông 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

Dùng 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 biết rằng người dùng đã xem giỏ hàng của họ.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 biết rằng người dùng đã xem một số nội dung. Sử dụng sự kiện này để khám phá những mặt hàng được xem nhiều nhất.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để 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ặt hàng trong items. Đừng thêm shipping hoặc tax. * Thông thường, bạn cần có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặt value.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 nhật ký sự kiện này khi người dùng được giới thiệu một danh sách các mặt hàng thuộc một danh mục nhất định.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của mặt hàng liên kết với sự kiện, theo định dạng ISO 4217 gồm 3 chữ cái. Chỉ số giá trị của sự kiện view_item không đóng góp vào doanh thu * Nếu bạn đặt value thì currency là thông số bắt buộc để tính toán chính xác chỉ số doanh thu.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
items	Array<Item>	Có		Các mặt hàng của sự kiện.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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.

Thông 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 khuyến mãi. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
promotion_id	string	Không	P_12345	Mã của chương trình khuyến mãi được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
promotion_name	string	Không	Giảm giá mùa hè	Tên của chương trình khuyến mãi được liên kết với sự kiện. Bị bỏ qua nếu được đặt ở cấp mặt hàng.
items	Array<Item>	Có*		Các mặt hàng của sự kiện. * Mảng items dự kiến sẽ có một phần tử duy nhất, đại diện cho mặt hàng được liên kết với chương trình khuyến mãi. Nếu bạn cung cấp nhiều phần tử, thì chỉ phần tử đầu tiên trong items sẽ được dùng.

Thông số mục

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
item_id	string	Có*	SKU_12345	Mã của mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
item_name	string	Có*	Áo thun Stan and Friends	Tên mặt hàng. *Bạn phải cung cấp item_id hoặc item_name.
affiliation	string	Không	Cửa hàng Google	Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế. Lưu ý: "mối liên kết" chỉ có ở phạm vi mặt hàng.
coupon	string	Không	SUMMER_FUN	Tên/mã phiếu giảm giá liên kết với mặt hàng. Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập với nhau.
creative_name	string	Không	summer_banner2	Tên của mẫu quảng cáo khuyến mãi. Nếu được đặt, creative_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng creative_name ở cấp sự kiện (nếu có).
creative_slot	string	Không	featured_app_1	Tên của vùng mẫu quảng cáo được liên kết với mặt hàng. Nếu được đặt, creative_slot ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng creative_slot ở cấp sự kiện (nếu có).
discount	number	Không	2.22	Giá trị chiết khấu bằng tiền cho mỗi đơ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ặt hàng trong danh sách.
item_brand	string	Không	Google	Thương hiệu của mặt hàng.
item_category	string	Không	Hàng may mặc	Danh mục của mặt hàng. Nếu được dùng trong hệ phân cấp danh mục hoặc thông tin phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2	string	Không	Người lớn	Thứ bậc danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3	string	Không	Áo	Thứ bậc danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4	string	Không	Nhóm sản xuất	Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5	string	Không	Cộc tay	Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id	string	Không	related_products	Mã của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện (nếu có).
item_list_name	string	Không	Sản phẩm có liên quan	Tên của danh sách chứa mặt hàng được hiển thị cho người dùng. Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant	string	Không	xanh lục	Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id	string	Không	ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco)	Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh. Lưu ý: "location id" chỉ có ở phạm vi mặt hàng.
price	number	Không	10,01	Giá theo đơn vị tiền tệ của mặt hàng, theo đơn vị của tham số đơn vị tiền tệ đã chỉ định. Nếu chiết khấu áp dụng cho mặt hàng, hãy đặt price thành giá theo đơn vị được chiết khấu và chỉ định mức chiết khấu giá theo đơn vị trong tham số discount.
promotion_id	string	Không	P_12345	Mã nhận dạng của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_id ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng promotion_id ở cấp sự kiện (nếu có).
promotion_name	string	Không	Giảm giá mùa hè	Tên của chương trình khuyến mãi được liên kết với mặt hàng. Nếu được đặt, promotion_name ở cấp sự kiện sẽ bị bỏ qua. Nếu bạn không đặt, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện (nếu có).
quantity	number	Không	3	Số lượng mặt hàng. Nếu không được đặt, quantity sẽ được đặt thành 1.

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

Gửi sự kiện

Dùng 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 nhật ký sự kiện này khi người dùng đã xem kết quả của một lượt tìm kiếm. Xin lưu ý rằng bạn có thể bật sự kiện view_search_results để thu thập tự động thông qua tính năng Đo lường sự kiện nâng cao trong Google Analytics.

Thông số

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

Lưu ý: Sự kiện view_search_results sẽ gửi tham số unique_search_term với giá trị là 1 nếu cụm từ tìm kiếm đó là duy nhất trong phiên hiện tại. Nếu cụm từ tìm kiếm đã được gửi trong phiên hiện tại, thì giá trị tham số là 0.

Gửi sự kiện

Dùng 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 người dùng liên hệ hoặc được người đại diện liên hệ.

Thông số

Tên	Loại	Bắt buộc	Giá trị mẫu	Mô tả
currency	string	Có*	2,79	Đơn vị tiền tệ của value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái. * Nếu bạn đặt value thì currency là thông số bắt buộc để tính toán chính xác chỉ số doanh thu.
value	number	Có*	30.03	Giá trị bằng tiền của sự kiện. * Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt value. * Bạn phải có currency nếu đặ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.

Gửi sự kiện

Dùng 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"
      }
    }]
  })
});