Sự kiện

dịch: đã tắt

ad_impression

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 bao gồm khi xuất sang các nền tảng quảng cáo khác (chẳng hạn như Google Ads).
  • Việc gửi sự kiện ad_impression bằng Giao thức đo lường 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 ghi lại bằng cách gắn thẻ hoặc SDK.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
ad_platform string Không MoPub Nền tảng quảng cáo.
ad_source string Không AdColony Nguồn quảng cáo.
ad_format string Không Biểu ngữ Định dạng quảng cáo.
ad_unit_name string Không Banner_03 Tên đơn vị quảng cáo.
currency string Không USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Không euro
Giá trị của lượt hiển thị quảng cáo.
* value thường là bắt buộc để có báo cáo hữu ích.
* currency là bắt buộc nếu bạn đặt value.

Gửi sự kiện

Dùng thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"ad_impression",
      "params":{
        "ad_platform": "MoPub",
        "ad_source": "AdColony",
        "ad_format": "Banner",
        "ad_unit_name": "Banner_03",
        "currency": "USD",
        "value": 3.99
      }
    }]
  })
});

add_payment_info

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

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì cần có currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* Phải có currency nếu bạn đặt value.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với sự kiện.

Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập.
payment_type string Không Thẻ tín dụng Phương thức thanh toán đã chọn.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
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ố quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_payment_info",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "payment_type": "Credit Card",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

Sự kiện này cho thấy một người dùng đã gửi thông tin vận chuyển trong một quy trình thanh toán thương mại điện tử.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với sự kiện.

Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập.
shipping_tier string Không Mặt đất Cấp vận chuyển (ví dụ: Ground, Air, Next-day) được chọn để giao mặt hàng đã mua.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong 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ó* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
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 Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
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ố quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

Sự kiện này cho biết rằng một mặt hàng đã được thêm vào danh sách yêu thích. Sử dụng sự kiện này để xác định các món quà phổ biến trong ứng dụng của bạn.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "add_to_wishlist",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

Sự kiện này biểu thị rằng người dùng đã bắt đầu quy trình thanh toán.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với sự kiện.

Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;


fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "begin_checkout",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

campaign_details

Sử dụng sự kiện này để gửi thông tin chi tiết về chiến dịch sẽ được áp dụng cho các sự kiện trong tương lai.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
campaign_id string Không google_1234 Mã chiến dịch.
campaign string Không Summer_fun Tên được sử dụng để xác định quảng cáo hoặc chiến dịch chiến lược cụ thể.
source string Không 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 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 kết quả tìm kiếm có trả phí để cung cấp từ khoá cho quảng cáo.
content string Không logolink Nội dung chiến dịch được dùng cho thử nghiệm A/B và quảng cáo nhắm mục tiêu theo nội dung để phân biệt các quảng cáo hoặc đường liên kết trỏ đến cùng một URL.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "campaign_details",
      "params": {
        "campaign_id": "google_1234",
        "campaign": "Summer_fun",
        "source": "google",
        "medium": "cpc",
        "term": "summer+travel",
        "content": "logolink"
      }
    }]
  })
});

close_convert_lead

Sự kiện này đo lường thời điểm một khách hàng tiềm năng đã được chuyển đổi và đã chốt (ví dụ: thông qua một giao dịch mua hàng).

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* value thường là bắt buộc để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_convert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

close_unconvert_lead

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

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của value của sự kiện, theo 3 chữ cái Định dạng ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
unconvert_lead_reason string Không Chưa bao giờ trả lời Lý do khiến khách hàng tiềm năng không được 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 một người dùng được đánh dấu là không đủ điều kiện để trở thành khách hàng tiềm năng, cùng với lý do không đủ điều kiện.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
disqualified_lead_reason string Không Không muốn mua Lý do khách hàng tiềm năng bị đánh dấu là không đủ điều kiện.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "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 lại thông tin này cùng với spend_virtual_currency để hiểu rõ hơn về kinh tế ảo.

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

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "earn_virtual_currency",
      "params": {
        "virtual_currency_name": "Gems",
        "value": 5
      }
    }]
  })
});

generate_lead

Sự kiện này đo lường thời điểm tạo khách hàng tiềm năng (ví dụ: thông qua một biểu mẫu). Ghi lại thông tin này để nắm được mức độ hiệu quả của các chiến dịch tiếp thị và có bao nhiêu khách hàng tương tác lại với doanh nghiệp của bạn sau khi tiếp thị lại khách hàng.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
lead_source string Không Triển lãm thương mại Nguồn của khách hàng tiềm năng.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "generate_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_source": "Trade show"
      }
    }]
  })
});

join_group

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

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ã của nhóm.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events":[{
      "name":"join_group",
      "params":{
        "group_id":"G_12345"
      }
    }]
  })
});

level_up

Sự kiện này báo hiệu rằng một người chơi đã lên cấp trong trò chơi. Sử dụng báo cáo này để đánh giá cơ sở người dùng theo cấp và xác định các mức độ khó đã hoàn tất.

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

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "level_up",
      "params": {
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

login

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

Thông số

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

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "login",
      "params": {
        "method": "Google"
      }
    }]
  })
});

post_score

Gửi sự kiện này khi người dùng đăng điểm số. Hãy sử dụng sự kiện này để tìm hiểu đang hoạt động hiệu quả như thế nào trong trò chơi của bạn và tạo mối liên hệ giữa điểm số cao với đối tượng hoặc của Google.

Thông số

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

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "post_score",
      "params": {
        "score": 10000,
        "level": 5,
        "character": "Player 1"
      }
    }]
  })
});

purchase

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

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
transaction_id string T_12345 Giá trị nhận dạng riêng biệt của một giao dịch.

Thông số transaction_id giúp bạn tránh lấy các sự kiện trùng lặp cho một giao dịch mua hàng.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với sự kiện.

Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập.
shipping number Không 3,33 Phí vận chuyển liên quan đến một giao dịch.
tax number Không 1,11 Chi phí thuế liên quan đến một giao dịch.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "purchase",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

qualify_lead

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

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "qualify_lead",
      "params": {
        "currency": "USD",
        "value": 30.03
      }
    }]
  })
});

refund

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

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
transaction_id string T_12345 Giá trị nhận dạng riêng biệt của một giao dịch.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Không bao gồm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với sự kiện.

Các thông số coupon ở cấp sự kiện và cấp mặt hàng là độc lập.
shipping number Không 3,33 Phí vận chuyển liên quan đến một giao dịch.
tax number Không 1,11 Chi phí thuế liên quan đến một giao dịch.
items Array<Item> Không* Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
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ố quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "refund",
      "params": {
        "currency": "USD",
        "transaction_id": "T_12345",
        "value": 30.03,
        "coupon": "SUMMER_FUN",
        "shipping": 3.33,
        "tax": 1.11,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

remove_from_cart

Sự kiện này cho biết một mặt hàng đã bị xoá khỏi giỏ hàng.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn phải có value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "remove_from_cart",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

screen_view

Sử dụng sự kiện này để biểu thị một lượt chuyển màn hình đã diễn ra.

Thông số

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

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "screen_view",
      "params": {
        "screen_class": "MainActivity",
        "screen_name": "About"
      }
    }]
  })
});

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

Thông số

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

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "search",
      "params": {
        "search_term": "t-shirts"
      }
    }]
  })
});

select_content

Sự kiện này cho 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 phổ biến và các danh mục nội dung trên trang web hoặc ứng dụng của bạn.

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

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_content",
      "params": {
        "content_type": "product",
        "content_id": "C_12345"
      }
    }]
  })
});

select_item

Sự kiện này biểu thị một mục đã được chọn từ danh sách.

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ỏ qua nếu thiết lập ở 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 đại diện cho mục đã chọn. Nếu nhiều phần tử được cung cấp, chỉ có phần tử đầu tiên trong items được sử dụng.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập 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

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_item",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

Sự kiện này biểu thị một chương trình khuyến mãi đã được chọn từ danh sách.

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.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo liên kết với sự kiện.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_id string Không P_12345 Mã của chương trình khuyến mãi được liên kết với sự kiện.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_name string Không Khuyến mại mùa hè Tên của chương trình khuyến mãi liên kết với sự kiện.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
items Array<Item> Không Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo liên kết với mục.

Nếu được đặt, creative_slot ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng creative_slot ở cấp sự kiện, nếu hiện tại.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id string Không P_12345 Mã của chương trình khuyến mãi liên kết với mặt hàng.

Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name string Không Khuyến mại mùa hè Tên của chương trình khuyến mãi liên kết với mặt hàng này.

Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập 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

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "select_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

share

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ã của nội dung được chia sẻ.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "share",
      "params": {
        "method": "Twitter",
        "content_type": "image",
        "item_id": "C_12345"
      }
    }]
  })
});

sign_up

Sự kiện này cho biết người dùng đã đăng ký một tài khoản. Sử dụng sự kiện này để hiểu các hành vi khác nhau của người dùng đã đăng nhập và đăng xuất.

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 dùng để đăng ký.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "sign_up",
      "params": {
        "method": "Google"
      }
    }]
  })
});

spend_virtual_currency

Sự kiện này đo lường hoạt động bán hàng hoá ảo trong ứng dụng của bạn và giúp bạn xác định loại hàng hoá ảo phổ biến nhất.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
value number 5 Giá trị của đơn vị tiền tệ ảo.
virtual_currency_name string Gem Tên đơn vị tiền tệ ảo.
item_name string Không Tăng cường khởi đầu Tên của mặt hàng mà đơn vị tiền tệ ảo đang được sử dụng.

Gửi sự kiện

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 làm quen. Sử dụng báo cáo này trong một phễu bằng tutorial_complete để biết có bao nhiêu người dùng hoàn thành hướng dẫn.

Thông số

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

Không có thông số nào cho sự kiện này.

Gửi sự kiện

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 làm quen. Sử dụng bản thảo này trong phễu có tutorial_begin để biết có bao nhiêu người dùng hoàn tất của chúng tôi.

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 lại sự kiện này khi người dùng đã mở khoá một thành tích. Sự kiện này có thể giúp bạn hiểu được trải nghiệm của người dùng khi chơi trò chơi.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
achievement_id string A_12345 Mã của thành tích đã được mở khoá.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "unlock_achievement",
      "params": {
        "achievement_id": "A_12345"
      }
    }]
  })
});

view_cart

Sự kiện này cho thấy rằng một người dùng đã xem giỏ hàng.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Đừng thêm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện chính, bạn nên đặt value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "mã vị trí" chỉ có ở phạm vi mặt hàng.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập thành 1.

Ngoài các thông số quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_cart",
      "params": {
        "currency": "USD",
        "value": 7.77,
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

Sự kiện này cho thấy rằng một số nội dung đã được hiển thị cho người dùng. Sử dụng sự kiện này để khám phá những mặt hàng được xem nhiều nhất.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của mặt hàng liên kết với sự kiện (theo đơn vị tiền tệ) 3 chữ cái ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* Đặt value thành tổng của (price * quantity) cho tất cả các mục trong items. Không bao gồm shipping hoặc tax.
* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Vị trí tuỳ chỉnh Mã nhận dạng cũng có thể được sử dụng.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập 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 lại sự kiện này khi người dùng được xem danh sách các mục của danh mục nhất định.

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ỏ qua nếu thiết lập ở cấp mặt hàng.
items Array<Item> Các mặt hàng cho sự kiện.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế của mặt hàng này (ví dụ: vị trí thực tế vị trí cửa hàng). Bạn nên sử dụng Google Mã địa điểm tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
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ố quy định, bạn có thể thêm đến 27 thông số tuỳ chỉnh trong mảng items.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_item_list",
      "params": {
        "item_list_id": "related_products",
        "item_list_name": "Related products",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_promotion

Sự kiện này cho biết một chương trình khuyến mãi đã được xem trong danh sách.

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.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo liên kết với sự kiện.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_id string Không P_12345 Mã của chương trình khuyến mãi được liên kết với sự kiện.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
promotion_name string Không Khuyến mại mùa hè Tên của chương trình khuyến mãi liên kết với sự kiện.

Bỏ qua nếu thiết lập ở cấp mặt hàng.
items Array<Item> Có* Các mặt hàng cho sự kiện.

* Mảng items dự kiến sẽ có một 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 có nhiều đã được cung cấp, thì chỉ phần tử đầu tiên trong items sẽ để sử dụng.

Thông số mục

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có* SKU_12345

Mã của mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

item_name string Có* Áo phông Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp một trong hai giá trị item_id hoặc item_name.

affiliation string Không Cửa hàng Google Đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc gạch và vị trí cửa hàng thực tế.
Lưu ý: `affiliation` chỉ có sẵn ở phạm vi mục.
coupon string Không SUMMER_FUN Tên/mã phiếu giảm giá liên kết với mặt hàng.

Các thông số coupon cấp sự kiện và cấp mặt hàng là độc lập.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo.

Nếu được đặt, creative_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng creative_name cấp sự kiện (nếu có).
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo liên kết với mục.

Nếu được đặt, creative_slot ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng creative_slot ở cấp sự kiện, nếu hiện tại.
discount number Không 2.22 Giá trị chiết khấu bằng tiền của đơn vị liên kết với mặt hàng này.
index number Không 5 Chỉ mục/vị trí của mục trong danh sách.
item_brand string Không 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ệ thống phân cấp danh mục hoặc hệ thống phân loại, thì đây sẽ là danh mục đầu tiên.
item_category2 string Không Người lớn Hệ thống phân cấp danh mục thứ hai hoặc phân loại bổ sung của mặt hàng.
item_category3 string Không Áo Hệ thống phân cấp danh mục thứ ba hoặc phân loại bổ sung của mặt hàng.
item_category4 string Không Nhóm sản xuất Thứ bậc danh mục thứ tư hoặc phân loại bổ sung của mặt hàng.
item_category5 string Không Áo ngắn tay Thứ bậc danh mục thứ năm hoặc phân loại bổ sung của mặt hàng.
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_id ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_id ở cấp sự kiện, nếu hiện tại.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Nếu được đặt, item_list_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện, nếu hiện tại.
item_variant string Không xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng cho mặt hàng bổ sung chi tiết/tùy chọn.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mặt hàng được liên kết. Bạn cũng có thể sử dụng mã nhận dạng vị trí tuỳ chỉnh.
Lưu ý: "location id" (id vị trí) chỉ có sẵn ở phạm vi mục.
price number Không 10,01 Đơn giá của mặt hàng bằng tiền tệ, tính bằng đơn vị tiền tệ được chỉ định .
Nếu mặt hàng có chiết khấu, hãy đặt price thành đơn giá chiết khấu và chỉ định chiết khấu theo đơn giá trong thông số discount.
promotion_id string Không P_12345 Mã của chương trình khuyến mãi liên kết với mặt hàng.

Nếu được đặt, promotion_id cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_id ở cấp sự kiện, nếu hiện tại.
promotion_name string Không Khuyến mại mùa hè Tên của chương trình khuyến mãi liên kết với mặt hàng này.

Nếu được đặt, promotion_name cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt chính sách này, hệ thống sẽ sử dụng promotion_name ở cấp sự kiện, nếu hiện tại.
quantity number Không 3

Số lượng mặt hàng.

Nếu bạn không đặt chính sách này, quantity sẽ được thiết lập 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

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_promotion",
      "params": {
        "creative_name": "Summer Banner",
        "creative_slot": "featured_app_1",
        "promotion_id": "P_12345",
        "promotion_name": "Summer Sale",
        "items": [
          {
            "item_id": "SKU_12345",
            "item_name": "Stan and Friends Tee",
            "affiliation": "Google Merchandise Store",
            "coupon": "SUMMER_FUN",
            "creative_name": "summer_banner2",
            "creative_slot": "featured_app_1",
            "currency": "USD",
            "discount": 2.22,
            "index": 0,
            "item_brand": "Google",
            "item_category": "Apparel",
            "item_category2": "Adult",
            "item_category3": "Shirts",
            "item_category4": "Crew",
            "item_category5": "Short sleeve",
            "item_list_id": "related_products",
            "item_list_name": "Related Products",
            "item_variant": "green",
            "location_id": "ChIJIQBpAG2ahYAR_6128GcTUEo",
            "price": 10.01,
            "promotion_id": "P_12345",
            "promotion_name": "Summer Sale",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_search_results

Ghi lại sự kiện này khi người dùng được hiển thị kết quả tìm kiếm. Xin lưu ý rằng bạn có thể bật sự kiện view_search_results để thu thập tự động thông qua tính năng Đo lường sự kiện nâng cao trong Google Analytics.

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.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "view_search_results",
      "params": {
        "search_term": "Clothing"
      }
    }]
  })
});

working_lead

Sự kiện này đo lường thời điểm người dùng liên hệ hoặc được nhân viên hỗ trợ liên hệ.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
currency string Có* USD Đơn vị tiền tệ của value trong sự kiện, theo 3 chữ cái Định dạng ISO 4217.

* Nếu bạn đặt value thì bạn phải dùng currency để tính toán chính xác chỉ số doanh thu.
value number Có* 30,03 Giá trị bằng tiền của sự kiện.

* value thường là bắt buộc để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện đó dưới dạng sự kiện chính, thì bạn nên đặt sự kiện đó value.
* currency là bắt buộc nếu bạn đặt value.
lead_status string Không Cuộc trò chuyện đã bắt đầu Trạng thái của khách hàng tiềm năng.

Gửi sự kiện

Hãy thử sự kiện này trong Trình tạo sự kiện của Google Analytics

const measurementId = `G-XXXXXXXXXX`;
const apiSecret = `<secret_value>`;

fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "working_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "lead_status": "Started conversations"
      }
    }]
  })
});