Hãy thử máy chủ MCP cho Google Analytics. Cài đặt từ
GitHub và xem
thông báo để biết thêm thông tin chi tiết.
REST Resource: properties.conversionEvents
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tài nguyên: ConversionEvent
Một sự kiện chuyển đổi trong tài sản Google Analytics.
Biểu diễn dưới dạng JSON |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (ConversionCountingMethod ),
"defaultConversionValue": {
object (DefaultConversionValue )
}
} |
Trường |
name |
string
Chỉ có đầu ra. Tên tài nguyên của sự kiện chuyển đổi này. Định dạng: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
Không thể thay đổi. Tên sự kiện cho sự kiện chuyển đổi này. Ví dụ: "lượt nhấp", "giao dịch mua"
|
createTime |
string (Timestamp format)
Chỉ có đầu ra. Thời gian tạo sự kiện chuyển đổi này trong tài sản. Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo Z và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ dời khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30" .
|
deletable |
boolean
Chỉ có đầu ra. Nếu được đặt, bạn hiện có thể xoá sự kiện này bằng conversionEvents.delete.
|
custom |
boolean
Chỉ có đầu ra. Nếu bạn đặt giá trị này thành true, thì sự kiện chuyển đổi này sẽ tham chiếu đến một sự kiện tuỳ chỉnh. Nếu được đặt thành false, sự kiện chuyển đổi này sẽ tham chiếu đến một sự kiện mặc định trong GA. Sự kiện mặc định thường có ý nghĩa đặc biệt trong GA. Hệ thống GA thường tạo sự kiện mặc định cho bạn, nhưng trong một số trường hợp, quản trị viên tài sản có thể tạo sự kiện mặc định. Sự kiện tuỳ chỉnh được tính vào số sự kiện chuyển đổi tuỳ chỉnh tối đa có thể tạo cho mỗi tài sản.
|
countingMethod |
enum (ConversionCountingMethod )
Không bắt buộc. Phương thức tính lượt chuyển đổi trên nhiều sự kiện trong một phiên. Nếu bạn không cung cấp giá trị này, giá trị này sẽ được đặt thành ONCE_PER_EVENT .
|
defaultConversionValue |
object (DefaultConversionValue )
Không bắt buộc. Xác định giá trị/đơn vị tiền tệ mặc định cho một sự kiện chuyển đổi.
|
ConversionCountingMethod
Phương thức tính lượt chuyển đổi trên nhiều sự kiện trong một phiên.
Enum |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
Chưa chỉ định phương thức tính. |
ONCE_PER_EVENT |
Mỗi thực thể Sự kiện được coi là một Lượt chuyển đổi. |
ONCE_PER_SESSION |
Mỗi phiên của mỗi người dùng chỉ được tính tối đa một lượt chuyển đổi cho một thực thể Sự kiện. |
DefaultConversionValue
Xác định giá trị/đơn vị tiền tệ mặc định cho một sự kiện chuyển đổi. Bạn phải cung cấp cả giá trị và đơn vị tiền tệ.
Biểu diễn dưới dạng JSON |
{
"value": number,
"currencyCode": string
} |
Trường |
value |
number
Giá trị này sẽ được dùng để điền sẵn giá trị cho tất cả lượt chuyển đổi của eventName đã chỉ định, trong đó thông số "value" của sự kiện chưa được đặt.
|
currencyCode |
string
Khi một sự kiện chuyển đổi cho eventName này không có đơn vị tiền tệ được đặt, đơn vị tiền tệ này sẽ được áp dụng làm đơn vị tiền tệ mặc định. Phải ở định dạng mã tiền tệ ISO 4217. Hãy xem https://en.wikipedia.org/wiki/ISO_4217 để biết thêm thông tin.
|
Phương thức |
create (deprecated)
|
Không dùng nữa: Hãy sử dụng CreateKeyEvent . |
delete (deprecated)
|
Không dùng nữa: Hãy sử dụng DeleteKeyEvent . |
get (deprecated)
|
Không dùng nữa: Hãy sử dụng GetKeyEvent . |
list (deprecated)
|
Không dùng nữa: Hãy sử dụng ListKeyEvents . |
patch (deprecated)
|
Không dùng nữa: Hãy sử dụng UpdateKeyEvent . |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-26 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-26 UTC."],[[["\u003cp\u003e\u003ccode\u003eConversionEvent\u003c/code\u003e resource represents a conversion event within a Google Analytics property, allowing for tracking and analysis of user actions.\u003c/p\u003e\n"],["\u003cp\u003eConversion events can be customized with specific names, counting methods, and default values to align with desired metrics.\u003c/p\u003e\n"],["\u003cp\u003eCounting methods include \u003ccode\u003eONCE_PER_EVENT\u003c/code\u003e and \u003ccode\u003eONCE_PER_SESSION\u003c/code\u003e, determining how conversions are attributed to events within a session.\u003c/p\u003e\n"],["\u003cp\u003eDefault conversion values can be assigned to events, providing a monetary or numerical representation of their significance.\u003c/p\u003e\n"],["\u003cp\u003eWhile some methods are deprecated, \u003ccode\u003eConversionEvent\u003c/code\u003e provides flexibility for understanding and optimizing user behavior within a Google Analytics property.\u003c/p\u003e\n"]]],["Conversion events, tracked in Google Analytics properties, represent specific user actions. Each event has a name, creation time, and can be set as deletable or custom. The counting method determines how events are counted within a session: \"once per event\" or \"once per session\". Default conversion values, including a numeric value and currency code, can be assigned. The methods `create`, `delete`, `get`, `list`, and `patch` for these events are deprecated.\n"],null,["# REST Resource: properties.conversionEvents\n\n- [Resource: ConversionEvent](#ConversionEvent)\n - [JSON representation](#ConversionEvent.SCHEMA_REPRESENTATION)\n- [ConversionCountingMethod](#ConversionCountingMethod)\n- [DefaultConversionValue](#DefaultConversionValue)\n - [JSON representation](#DefaultConversionValue.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: ConversionEvent\n-------------------------\n\nA conversion event in a Google Analytics property.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"eventName\": string, \"createTime\": string, \"deletable\": boolean, \"custom\": boolean, \"countingMethod\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents#ConversionCountingMethod), \"defaultConversionValue\": { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents#DefaultConversionValue) } } ``` |\n\n| Fields ||\n|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name of this conversion event. Format: properties/{property}/conversionEvents/{conversionEvent} |\n| `eventName` | `string` Immutable. The event name for this conversion event. Examples: 'click', 'purchase' |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time when this conversion event was created in the property. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than \"Z\" are also accepted. Examples: `\"2014-10-02T15:01:23Z\"`, `\"2014-10-02T15:01:23.045123456Z\"` or `\"2014-10-02T15:01:23+05:30\"`. |\n| `deletable` | `boolean` Output only. If set, this event can currently be deleted with conversionEvents.delete. |\n| `custom` | `boolean` Output only. If set to true, this conversion event refers to a custom event. If set to false, this conversion event refers to a default event in GA. Default events typically have special meaning in GA. Default events are usually created for you by the GA system, but in some cases can be created by property admins. Custom events count towards the maximum number of custom conversion events that may be created per property. |\n| `countingMethod` | `enum (`[ConversionCountingMethod](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents#ConversionCountingMethod)`)` Optional. The method by which conversions will be counted across multiple events within a session. If this value is not provided, it will be set to `ONCE_PER_EVENT`. |\n| `defaultConversionValue` | `object (`[DefaultConversionValue](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents#DefaultConversionValue)`)` Optional. Defines a default value/currency for a conversion event. |\n\nConversionCountingMethod\n------------------------\n\nThe method by which conversions will be counted across multiple events within a session.\n\n| Enums ||\n|------------------------------------------|---------------------------------------------------------------------------------|\n| `CONVERSION_COUNTING_METHOD_UNSPECIFIED` | Counting method not specified. |\n| `ONCE_PER_EVENT` | Each Event instance is considered a Conversion. |\n| `ONCE_PER_SESSION` | An Event instance is considered a Conversion at most once per session per user. |\n\nDefaultConversionValue\n----------------------\n\nDefines a default value/currency for a conversion event. Both value and currency must be provided.\n\n| JSON representation |\n|-----------------------------------------------------|\n| ``` { \"value\": number, \"currencyCode\": string } ``` |\n\n| Fields ||\n|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `value` | `number` This value will be used to populate the value for all conversions of the specified eventName where the event \"value\" parameter is unset. |\n| `currencyCode` | `string` When a conversion event for this eventName has no set currency, this currency will be applied as the default. Must be in ISO 4217 currency code format. See \u003chttps://en.wikipedia.org/wiki/ISO_4217\u003e for more information. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------------------------------------|-------------------------------------------|\n| ### [create](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/create)` ` **(deprecated)** | Deprecated: Use `CreateKeyEvent` instead. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/delete)` ` **(deprecated)** | Deprecated: Use `DeleteKeyEvent` instead. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/get)` ` **(deprecated)** | Deprecated: Use `GetKeyEvent` instead. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/list)` ` **(deprecated)** | Deprecated: Use `ListKeyEvents` instead. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.conversionEvents/patch)` ` **(deprecated)** | Deprecated: Use `UpdateKeyEvent` instead. |"]]