Sự kiện được đề xuất của Google Analytics

Sau đây là danh sách các sự kiện được đề xuất. Bạn cũng có thể tạo và gửi sự kiện tuỳ chỉnh của riêng mình.

Khi tạo tên sự kiện tuỳ chỉnh, bạn phải:

  1. Tuân thủ Quy tắc đặt tên sự kiện.
  2. Tránh Tên và tiền tố chuyên dụng.
  3. Tuân thủ Hạn mức thu thập sự kiện, chẳng hạn như giới hạn 40 ký tự cho tên sự kiện và thông số.

Hãy xem phần Bắt đầu sử dụng để biết thông tin chi tiết.

Nếu bạn đang nâng cấp từ Measurement Protocol, hãy xem bài viết Nâng cấp từ Measurement Protocol để biết hướng dẫn.

Dành cho mọi tài sản

ad_impression

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

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

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

Trường sự kiện

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

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

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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện ad_impression bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "ad_impression",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 3.99,
      "additionalEventParameters": [
        {
          "parameterName": "ad_platform",
          "value": "MoPub"
        },
        {
          "parameterName": "ad_source",
          "value": "AdColony"
        },
        {
          "parameterName": "ad_format",
          "value": "Banner"
        },
        {
          "parameterName": "ad_unit_name",
          "value": "Banner_03"
        }
      ]
    }
  ]
}

Measurement Protocol

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

earn_virtual_currency

Sự kiện này đo lường thời điểm người dùng được thưởng tiền ảo trong một trò chơi. Ghi nhật ký sự kiện này cùng với spend_virtual_currency để hiểu rõ hơn về nền kinh tế ảo của bạn.

Trường sự kiện

Tên Loại Bắt buộc Giá trị mẫu Mô tả
conversion_value number Không 5 Giá trị của đơn vị tiền 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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện earn_virtual_currency bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "earn_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

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

join_group

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

Thông số

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

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện join_group bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "join_group",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "group_id",
          "value": "G_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

login

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

Thông số

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

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện login bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "login",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

screen_view

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

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

Thông số

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

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện screen_view bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "screen_view",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "additionalEventParameters": [
        {
          "parameterName": "screen_class",
          "value": "MainActivity"
        },
        {
          "parameterName": "screen_name",
          "value": "About"
        }
      ]
    }
  ]
}

Measurement Protocol

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

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

Thông số

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

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện search bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "search",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "t-shirts"
        }
      ]
    }
  ]
}

Measurement Protocol

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

select_content

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

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
content_type string Không sản phẩm Loại nội dung đã chọn.
content_id string Không C_12345 Giá trị nhận dạng cho nội dung đã chọn. Giá trị phải có ít nhất một ký tự không phải là số.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện select_content bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_content",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "content_type",
          "value": "product"
        },
        {
          "parameterName": "content_id",
          "value": "C_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

share

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

Trường sự kiện

Tên Loại Bắt buộc Giá trị mẫu Mô tả
cart_data.items Item[] Không Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

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ẻ.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện share bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "share",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "C_12345",
            "quantity": 1,
            "unitPrice": 27.67
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Twitter"
        },
        {
          "parameterName": "content_type",
          "value": "image"
        }
      ]
    }
  ]
}

Measurement Protocol

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

sign_up

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

Thông số

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

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện sign_up bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "sign_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "method",
          "value": "Google"
        }
      ]
    }
  ]
}

Measurement Protocol

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

spend_virtual_currency

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

Trường sự kiện

Tên Loại Bắt buộc Giá trị mẫu Mô tả
conversion_value number Có 5 Giá trị của đơn vị tiền tệ ảo.
cart_data.items Item[] Không Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Không Starter Boost Tên của mặt hàng mà đơn vị tiền tệ ảo đang được dùng.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
virtual_currency_name string Có Gem Tên đơn vị tiền tệ ảo.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện spend_virtual_currency bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "spend_virtual_currency",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "cartData": {
        "items": [
          {
            "itemId": "I_12345",
            "quantity": 1,
            "unitPrice": 27.67,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Starter Boost"
              }
            ]
          }
        ]
      },
      "conversionValue": 5,
      "additionalEventParameters": [
        {
          "parameterName": "virtual_currency_name",
          "value": "Gems"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "spend_virtual_currency",
      "params": {
        "value": 5,
        "virtual_currency_name": "Gems",
        "item_name": "Starter Boost"
      }
    }]
  })
});

tutorial_begin

Sự kiện này đánh dấu sự bắt đầu của quy trình tham gia. Sử dụng sự kiện này trong một phễu cùng với tutorial_complete để biết số lượng người dùng hoàn tất hướng dẫn.

Thông số

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

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện tutorial_begin bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_begin",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "tutorial_begin"
    }]
  })
});

tutorial_complete

Sự kiện này cho biết người dùng đã hoàn tất quy trình tham gia. Sử dụng tham số này trong một phễu có tutorial_begin để biết số lượng người dùng hoàn tất hướng dẫn.

Thông số

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

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện tutorial_complete bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "tutorial_complete",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID"
    }
  ]
}

Measurement Protocol

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

view_search_results

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

Thông số

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

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện view_search_results bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_search_results",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "search_term",
          "value": "Clothing"
        }
      ]
    }
  ]
}

Measurement Protocol

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

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 có dấu thời gian lớn hơn hoặc bằng dấu thời gian của sự kiện campaign_details.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
campaign_id string Không google_1234 Mã chiến dịch.
campaign string Không Summer_fun Tên dùng để xác định một chương trình khuyến mãi hoặc chiến dịch mang tính chiến lược cụ thể.
source string Không google Nguồn lưu lượng truy cập của chiến dịch (ví dụ: google, email, v.v.).
medium string Không cpc Phương tiện của chiến dịch (ví dụ: email, chi phí mỗi lượt nhấp, v.v.)
term string Không summer+travel Cụm từ chiến dịch được dùng với quảng cáo tìm kiếm có trả phí để cung cấp từ khoá cho quảng cáo.
content string Không logolink Nội dung chiến dịch được dùng cho thử nghiệm A/B và quảng cáo nhắm mục tiêu theo nội dung để phân biệt những quảng cáo hoặc đường liên kết trỏ đến cùng một URL.

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện campaign_details bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "campaign_details",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "campaign_id",
          "value": "google_1234"
        },
        {
          "parameterName": "campaign",
          "value": "Summer_fun"
        },
        {
          "parameterName": "source",
          "value": "google"
        },
        {
          "parameterName": "medium",
          "value": "cpc"
        },
        {
          "parameterName": "term",
          "value": "summer+travel"
        },
        {
          "parameterName": "content",
          "value": "logolink"
        }
      ]
    }
  ]
}

Measurement Protocol

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

Doanh số bán hàng trực tuyến

add_payment_info

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

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.
cart_data.coupon_codes string[] Không SUMMER_FUN Mã phiếu giảm giá liên kết với sự kiện.


Đặt trường coupon_codes trên đối tượng CartData.
* Chỉ cung cấp một mã giảm giá trong danh sách này.
* Thông số này độc lập với mã phiếu giảm giá ở cấp mặt hàng.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
payment_type string Không Thẻ tín dụng Phương thức thanh toán đã chọn.

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện add_payment_info bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_payment_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "payment_type",
          "value": "Credit Card"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_shipping_info

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

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.
cart_data.coupon_codes string[] Không SUMMER_FUN Mã phiếu giảm giá liên kết với sự kiện.


Đặt trường coupon_codes trên đối tượng CartData.
* Chỉ cung cấp một mã giảm giá trong danh sách này.
* Thông số này độc lập với mã phiếu giảm giá ở cấp mặt hàng.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
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.

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện add_shipping_info bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_shipping_info",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping_tier",
          "value": "Ground"
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "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.

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện add_to_cart bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

add_to_wishlist

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

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện add_to_wishlist bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "add_to_wishlist",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

begin_checkout

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

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.
cart_data.coupon_codes string[] Không SUMMER_FUN Mã phiếu giảm giá liên kết với sự kiện.


Đặt trường coupon_codes trên đối tượng CartData.
* Chỉ cung cấp một mã giảm giá trong danh sách này.
* Thông số này độc lập với mã phiếu giảm giá ở cấp mặt hàng.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện begin_checkout bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "begin_checkout",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

in_app_purchase

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

Hãy sử dụng sự kiện này khi người dùng mua hàng trong ứng dụng.

Trường sự kiện

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 conversion_value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Thông thường, bạn phải cung cấp conversion_value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Không Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
product_id string Không ABC123456789 Mã nhận dạng của sản phẩm.
subscription boolean Không true

Cho biết liệu giao dịch mua có phải là gói thuê bao hay không.
Nếu không được đặt, giá trị mặc định sẽ là false.
free_trial boolean Không true

Cho biết liệu sự kiện có phải là sự kiện dùng thử miễn phí của một gói thuê bao hay không.
Nếu không được đặt, giá trị mặc định sẽ là false.
price_is_discounted boolean Không false

Cho biết liệu price có được chiết khấu hay không.
Nếu không được đặt, giá trị mặc định sẽ là false.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện in_app_purchase bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "FIREBASE_APP_ID"
    }
  ],
  "events": [
    {
      "eventName": "in_app_purchase",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "APP",
      "appInstanceId": "APP_INSTANCE_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "cartData": {
        "items": [
          {
            "itemId": "ABC123456789",
            "quantity": 3,
            "unitPrice": 10.01
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "subscription",
          "value": true
        },
        {
          "parameterName": "free_trial",
          "value": false
        },
        {
          "parameterName": "price_is_discounted",
          "value": false
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "app_instance_id": "app_instance_id",
    "events":[{
      "name":"in_app_purchase",
      "params":{
        "currency": "USD",
        "value": 30.03,
        "quantity": 3,
        "product_id": "ABC123456789",
        "subscription": true,
        "free_trial": false,
        "price_is_discounted": false
      }
    }]
  })
});

purchase

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

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

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

Thông số transaction_id giúp bạn tránh lấy các sự kiện trùng lặp cho một giao dịch mua hàng. Đặt trường transaction_id trên đối tượng Event.
user_properties.customer_type CustomerType Không NEW Lượt chuyển đổi có đến từ khách hàng NEW hay RETURNING.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.
cart_data.coupon_codes string[] Không SUMMER_FUN Mã phiếu giảm giá liên kết với sự kiện.


Đặt trường coupon_codes trên đối tượng CartData.
* Chỉ cung cấp một mã giảm giá trong danh sách này.
* Thông số này độc lập với mã phiếu giảm giá ở cấp mặt hàng.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
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.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện purchase bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "purchase",
      "transactionId": "TRANSACTION_ID",
      "conversionValue": 83.99,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "userProperties": {
        "customerType": "RETURNING"
      },
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 3,
            "unitPrice": 10.01,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Stan and Friends Tee"
              },
              {
                "parameterName": "affiliation",
                "value": "Google Merchandise Store"
              },
              {
                "parameterName": "discount",
                "value": "2.22"
              },
              {
                "parameterName": "index",
                "value": "0"
              },
              {
                "parameterName": "item_brand",
                "value": "Google"
              },
              {
                "parameterName": "item_category",
                "value": "Apparel"
              },
              {
                "parameterName": "item_category2",
                "value": "Adult"
              },
              {
                "parameterName": "item_category3",
                "value": "Shirts"
              },
              {
                "parameterName": "item_category4",
                "value": "Crew"
              },
              {
                "parameterName": "item_category5",
                "value": "Short sleeve"
              },
              {
                "parameterName": "item_list_id",
                "value": "related_products"
              },
              {
                "parameterName": "item_list_name",
                "value": "Related Products"
              },
              {
                "parameterName": "item_variant",
                "value": "green"
              },
              {
                "parameterName": "location_id",
                "value": "ChIJIQBpAG2ahYAR_6128GcTUEo"
              },
              {
                "parameterName": "google_business_vertical",
                "value": "retail"
              }
            ]
          }
        ]
      },
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": "3.33"
        },
        {
          "parameterName": "tax",
          "value": "1.11"
        }
      ]
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

refund

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

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
transaction_id string Có T_12345 Giá trị nhận dạng riêng biệt của một giao dịch.
cart_data.items Item[] Không Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.
cart_data.coupon_codes string[] Không SUMMER_FUN Mã phiếu giảm giá liên kết với sự kiện.


Đặt trường coupon_codes trên đối tượng CartData.
* Chỉ cung cấp một mã giảm giá trong danh sách này.
* Thông số này độc lập với mã phiếu giảm giá ở cấp mặt hàng.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
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.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện refund bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "refund",
      "conversionValue": 30.03,
      "currency": "USD",
      "transactionId": "T_12345",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "shipping",
          "value": 3.33
        },
        {
          "parameterName": "tax",
          "value": 1.11
        }
      ],
      "cartData": {
        "couponCodes": [
          "SUMMER_FUN"
        ],
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "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.

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện remove_from_cart bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "remove_from_cart",
      "conversionValue": 30.03,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_item

Sự kiện này cho biết một mục đã được chọn trong danh sách.

Trường sự kiện

Tên Loại Bắt buộc Giá trị mẫu Mô tả
cart_data.items Item[] Có* Các mặt hàng của sự kiện.

* Mảng items dự kiến sẽ có một phần tử duy nhất, đại diện cho mục đã chọn. Nếu bạn cung cấp nhiều phần tử, thì chỉ phần tử đầu tiên trong items sẽ được sử dụng.

Đặt trường cart_data.items trên đối tượng Event.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_list_id string Không related_products Mã của danh sách chứa mặt hàng được hiển thị cho người dùng.

Bị bỏ qua nếu được đặt ở cấp mặt hàng.
item_list_name string Không Sản phẩm có liên quan Tên của danh sách chứa mặt hàng được hiển thị cho người dùng.

Bị bỏ qua nếu được đặt ở cấp mặt hàng.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện select_item bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_item",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

select_promotion

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

Trường sự kiện

Tên Loại Bắt buộc Giá trị mẫu Mô tả
cart_data.items Item[] Không Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
creative_name string Không summer_banner2 Tên của mẫu quảng cáo khuyến mãi.
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo được liên kết với sự kiện.
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.
promotion_name string Không Giảm giá mùa hè Tên của chương trình khuyến mãi được liên kết với sự kiện.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

affiliation string Không Cửa hàng Google Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế.
Lưu ý: affiliation chỉ có ở 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 với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo khuyến mãi.

Mặc định là creative_name ở cấp sự kiện nếu không được đặt.
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với mặt hàng.

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

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

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

Mặc định là promotion_id ở cấp sự kiện nếu không được đặt.
promotion_name string Không Giảm giá mùa hè Tên của chương trình khuyến mãi được liên kết với mặt hàng.

Mặc định là promotion_name ở cấp sự kiện nếu không được đặt.
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.

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện select_promotion bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "select_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_cart

Sự kiện này cho biết rằng người dùng đã xem giỏ hàng của họ.

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện view_cart bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_cart",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

view_item

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

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Đặt conversion_value thành tổng của (price * quantity) cho tất cả các mặt hàng trong items. Đừng thêm shipping hoặc tax.
* Thông thường, bạn cần có conversion_value để có báo cáo hữu ích. Nếu bạn đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện view_item bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item",
      "conversionValue": 7.77,
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          },
          {
            "itemId": "SKU_67890",
            "quantity": 2,
            "unitPrice": 24.00,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Google Red Team Hat"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ],
      }
    }]
  })
});

view_item_list

Ghi nhật ký sự kiện này khi người dùng được giới thiệu một danh sách các mặt hàng thuộc một danh mục nhất định.

Trường sự kiện

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 định dạng ISO 4217 gồm 3 chữ cái.

* Các chỉ số về giá trị của sự kiện view_item sẽ không đóng góp vào doanh thu

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
cart_data.items Item[] Có Các mặt hàng của sự kiện.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

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

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

Nếu được đặt, item_list_name ở cấp sự kiện sẽ bị bỏ qua.
Nếu bạn không đặt, hệ thống sẽ sử dụng item_list_name ở cấp sự kiện (nếu có).
item_variant string Không màu xanh lục Biến thể của mặt hàng hoặc mã hay nội dung mô tả riêng để cho biết thêm thông tin chi tiết/tuỳ chọn về mặt hàng.
location_id string Không ChIJIQBpAG2ahYAR_6128GcTUEo (Mã địa điểm của Google cho San Francisco) Vị trí thực tế liên kết với mặt hàng (ví dụ: vị trí cửa hàng thực tế). Bạn nên sử dụng Mã địa điểm của Google tương ứng với mục được liên kết. Bạn cũng có thể sử dụng mã vị trí tuỳ chỉnh.
Lưu ý: location_id chỉ có ở phạm vi mục.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện view_item_list bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_item_list",
      "currency": "USD",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "item_list_id",
          "value": "related_products"
        },
        {
          "parameterName": "item_list_name",
          "value": "Related products"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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,
            "google_business_vertical": "retail",
            "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.

Trường sự kiện

Tên Loại Bắt buộc Giá trị mẫu Mô tả
cart_data.items Item[] Có* Các mặt hàng của sự kiện.

* Mảng items dự kiến sẽ có một phần tử duy nhất, đại diện cho mặt hàng được liên kết với chương trình khuyến mãi. Nếu bạn cung cấp nhiều phần tử, thì chỉ phần tử đầu tiên trong items sẽ được sử dụng.

Đặt trường cart_data.items trên đối tượng Event.

Trường mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_id string Có I_12345 Giá trị nhận dạng riêng biệt của mặt hàng. Đặt trường item_id trên đối tượng Item.
unit_price number Có 27,67 Giá của một đơn vị hàng, chưa bao gồm thuế, phí vận chuyển và các khoản chiết khấu ở cấp sự kiện (cấp giao dịch) cho mặt hàng này.

Nếu mặt hàng có chiết khấu theo phạm vi mặt hàng, hãy sử dụng giá theo đơn vị đã chiết khấu. Ví dụ: Nếu một mặt hàng có đơn giá là 27,67 và chiết khấu theo đơn vị là 6,66, thì hãy đặt unitPrice thành 21,01.
quantity number Có 1 Số lượng đơn vị đã mua cho mặt hàng cụ thể này.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
creative_name string Không summer_banner2 Tên của mẫu quảng cáo khuyến mãi.
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo được liên kết với sự kiện.
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.
promotion_name string Không Giảm giá mùa hè Tên của chương trình khuyến mãi được liên kết với sự kiện.

Tham số mặt hàng

Tên Loại Bắt buộc Giá trị mẫu Mô tả
item_name string Có* Áo thun Stan and Friends

Tên mặt hàng.

*Bạn phải cung cấp item_id hoặc item_name.

affiliation string Không Cửa hàng Google Một đơn vị liên kết sản phẩm để chỉ định công ty cung cấp hoặc vị trí cửa hàng thực tế.
Lưu ý: affiliation chỉ có ở 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 với nhau.
creative_name string Không summer_banner2 Tên của mẫu quảng cáo khuyến mãi.

Mặc định là creative_name ở cấp sự kiện nếu không được đặt.
creative_slot string Không featured_app_1 Tên của vùng mẫu quảng cáo khuyến mãi được liên kết với mặt hàng.

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

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

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

Mặc định là promotion_id ở cấp sự kiện nếu không được đặt.
promotion_name string Không Giảm giá mùa hè Tên của chương trình khuyến mãi được liên kết với mặt hàng.

Mặc định là promotion_name ở cấp sự kiện nếu không được đặt.
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện view_promotion bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "view_promotion",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "userId": "USER_ID",
      "additionalEventParameters": [
        {
          "parameterName": "creative_name",
          "value": "Summer Banner"
        },
        {
          "parameterName": "creative_slot",
          "value": "featured_app_1"
        },
        {
          "parameterName": "promotion_id",
          "value": "P_12345"
        },
        {
          "parameterName": "promotion_name",
          "value": "Summer Sale"
        }
      ],
      "cartData": {
        "items": [
          {
            "itemId": "SKU_12345",
            "quantity": 1,
            "unitPrice": 29.99,
            "additionalItemParameters": [
              {
                "parameterName": "item_name",
                "value": "Triblend Android T-Shirt"
              }
            ]
          }
        ]
      }
    }
  ]
}

Measurement Protocol

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",
            "google_business_vertical": "retail",
            "quantity": 3
          }
        ]
      }
    }]
  })
});

Trò chơi

level_up

Sự kiện này cho biết người chơi đã lên cấp trong một trò chơi. Sử dụng chỉ số này để đánh giá mức độ phân bổ của cơ sở người dùng và xác định những cấp độ khó hoàn thành.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
level number Không 5 Cấp độ của nhân vật.
character string Không Người chơi 1 Nhân vật đã lên cấp.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện level_up bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "level_up",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

post_score

Gửi sự kiện này khi người dùng đăng điểm số. Hãy sử dụng sự kiện này để biết hiệu suất của người dùng trong trò chơi và tương quan điểm số cao với đối tượng hoặc hành vi.

Thông số

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

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện post_score bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "post_score",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "score",
          "value": 10000
        },
        {
          "parameterName": "level",
          "value": 5
        },
        {
          "parameterName": "character",
          "value": "Player 1"
        }
      ]
    }
  ]
}

Measurement Protocol

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

unlock_achievement

Ghi nhật ký sự kiện này khi người dùng đạt được một thành tích. Sự kiện này có thể giúp bạn nắm được trải nghiệm của người dùng về trò chơi của bạn.

Thông số

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

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện unlock_achievement bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "unlock_achievement",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "additionalEventParameters": [
        {
          "parameterName": "achievement_id",
          "value": "A_12345"
        }
      ]
    }
  ]
}

Measurement Protocol

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

Khả năng tạo khách hàng tiềm năng

close_convert_lead

Ghi nhật ký sự kiện này khi một khách hàng tiềm năng đủ tiêu chuẩn được chuyển đổi thành công thành khách hàng. Điều này thường biểu thị sự kết thúc của quy trình nuôi dưỡng khách hàng tiềm năng, chẳng hạn như khi hợp đồng được ký kết, gói thuê bao có tính phí bắt đầu hoặc giao dịch bán hàng cuối cùng hoàn tất.

  • Lưu ý: Để theo dõi lượt thu nạp khách hàng tiềm năng ban đầu, chẳng hạn như lượt gửi biểu mẫu, lượt đăng ký nhận bản tin hoặc lượt yêu cầu bản minh họa, hãy sử dụng sự kiện generate_lead.

Trường sự kiện

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 conversion_value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Thông thường, bạn phải cung cấp conversion_value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện close_convert_lead bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_convert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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

close_unconvert_lead

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

Trường sự kiện

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 conversion_value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Thông thường, bạn phải cung cấp conversion_value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
unconvert_lead_reason string Không Chưa bao giờ phản hồi Lý do khách hàng tiềm năng không chuyển đổi.

Ví dụ:

Ví dụ sau đây minh hoạ cách gửi sự kiện close_unconvert_lead bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "close_unconvert_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "unconvert_lead_reason",
          "value": "Never responded"
        }
      ]
    }
  ]
}

Measurement Protocol

const measurementId = 'G-XXXXXXXXXX';
const apiSecret = '<secret_value>';
 
fetch(`https://www.google-analytics.com/mp/collect?measurement_id=${measurementId}&api_secret=${apiSecret}`, {
  method: "POST",
  body: JSON.stringify({
    "client_id": "client_id",
    "events": [{
      "name": "close_unconvert_lead",
      "params": {
        "currency": "USD",
        "value": 30.03,
        "unconvert_lead_reason": "Never responded"
      }
    }]
  })
});

disqualify_lead

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

Trường sự kiện

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 conversion_value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Thông thường, bạn phải cung cấp conversion_value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
disqualified_lead_reason string Không Không có ý định mua Lý do một khách hàng tiềm năng bị đánh dấu là không đủ tiêu chuẩn.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện disqualify_lead bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "disqualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "disqualified_lead_reason",
          "value": "Not looking to buy"
        }
      ]
    }
  ]
}

Measurement Protocol

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

generate_lead

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

Trường sự kiện

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 conversion_value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Thông thường, bạn phải cung cấp conversion_value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện generate_lead bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "generate_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_source",
          "value": "Trade show"
        }
      ]
    }
  ]
}

Measurement Protocol

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

qualify_lead

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

Trường sự kiện

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 conversion_value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Thông thường, bạn phải cung cấp conversion_value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện qualify_lead bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "qualify_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03
    }
  ]
}

Measurement Protocol

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

working_lead

Sự kiện này đo lường thời điểm người dùng liên hệ hoặc được người đại diện liên hệ.

Trường sự kiện

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 conversion_value của sự kiện, ở định dạng ISO 4217 gồm 3 chữ cái.

* Nếu bạn đặt conversion_value thì currency là tham số bắt buộc để tính toán chính xác chỉ số doanh thu.
conversion_value number Có* 30.03 Giá trị bằng tiền của sự kiện.

* Thông thường, bạn phải cung cấp conversion_value để có báo cáo hữu ích. Nếu đánh dấu sự kiện là sự kiện quan trọng, thì bạn nên đặt conversion_value.
* Bạn phải có currency nếu đặt conversion_value.

Thông số

Tên Loại Bắt buộc Giá trị mẫu Mô tả
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.

Ví dụ:

Ví dụ sau đây cho thấy cách gửi sự kiện working_lead bằng Data Manager API. Nếu bạn đang nâng cấp từ Measurement Protocol, hãy sử dụng các thẻ để di chuyển yêu cầu sang Data Manager API.

Data Manager API


{
  "destinations": [
    {
      "operatingAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "loginAccount": {
        "accountType": "GOOGLE_ANALYTICS_PROPERTY",
        "accountId": "GOOGLE_ANALYTICS_PROPERTY_ID"
      },
      "productDestinationId": "MEASUREMENT_ID"
    }
  ],
  "events": [
    {
      "eventName": "working_lead",
      "eventTimestamp": "2025-06-10T23:42:33-05:00",
      "eventSource": "WEB",
      "clientId": "CLIENT_ID",
      "currency": "USD",
      "conversionValue": 30.03,
      "additionalEventParameters": [
        {
          "parameterName": "lead_status",
          "value": "Started conversations"
        }
      ]
    }
  ]
}

Measurement Protocol

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