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.keyEvents
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: KeyEvent
Một sự kiện chính 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 (CountingMethod ),
"defaultValue": {
object (DefaultValue )
}
} |
Trường |
name |
string
Chỉ có đầu ra. Tên tài nguyên của sự kiện chính này. Định dạng: properties/{property}/keyEvents/{keyEvent}
|
eventName |
string
Không thể thay đổi. Tên sự kiện cho sự kiện nhấn phím 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 chính 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 bạn đặt thành true, thì sự kiện này có thể bị xoá.
|
custom |
boolean
Chỉ có đầu ra. Nếu được đặt thành true, sự kiện chính 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 chính 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ố lượng sự kiện chính tuỳ chỉnh tối đa có thể tạo cho mỗi tài sản.
|
countingMethod |
enum (CountingMethod )
Bắt buộc. Phương thức tính Sự kiện chính trên nhiều sự kiện trong một phiên.
|
defaultValue |
object (DefaultValue )
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 nhấn phím.
|
CountingMethod
Phương thức tính Sự kiện chính trên nhiều sự kiện trong một phiên.
Enum |
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 Sự kiện chính. |
ONCE_PER_SESSION |
Mỗi phiên của mỗi người dùng chỉ được tính tối đa một phiên bản Sự kiện là Sự kiện chính. |
DefaultValue
Xác định giá trị/đơn vị tiền tệ mặc định cho một sự kiện nhấn phím.
Biểu diễn dưới dạng JSON |
{
"numericValue": number,
"currencyCode": string
} |
Trường |
numericValue |
number
Bắt buộc. Giá trị này sẽ được dùng để điền thông số "value" cho tất cả các lần xuất hiện của Sự kiện chính này (do eventName chỉ định) khi thông số đó chưa được đặt.
|
currencyCode |
string
Bắt buộc. Khi một lần xuất hiện của Sự kiện chính này (do eventName chỉ định) không có đơn vị tiền tệ được đặt, thì đơ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 |
|
Tạo một sự kiện chính. |
|
Xoá một Sự kiện chính. |
|
Truy xuất một Sự kiện chính. |
|
Trả về danh sách Sự kiện phím trong thuộc tính mẹ đã chỉ định. |
|
Cập nhật một Sự kiện chính. |
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\u003eKeyEvent resources represent significant events within a Google Analytics property, such as clicks or purchases, and can be custom or default.\u003c/p\u003e\n"],["\u003cp\u003eKey Events have a counting method that determines how they are tallied across multiple events in a session (e.g., once per event or once per session).\u003c/p\u003e\n"],["\u003cp\u003eIt is possible to define a default numeric value and currency for a Key Event, which will be used if these parameters are not set in the event data.\u003c/p\u003e\n"],["\u003cp\u003eGoogle Analytics provides API methods to manage Key Events, including creating, deleting, retrieving, listing, and updating them.\u003c/p\u003e\n"]]],["Key Events in Google Analytics track specific actions within a property, identified by an `eventName`. Each Key Event can have a `countingMethod` (`ONCE_PER_EVENT` or `ONCE_PER_SESSION`). They may have a `defaultValue` with a `numericValue` and `currencyCode`. Key Events are created, retrieved, listed, updated, and deleted via dedicated methods. Key events can be default or custom and store information such as if they are deletable, their creation time and their resource name.\n"],null,["# REST Resource: properties.keyEvents\n\n- [Resource: KeyEvent](#KeyEvent)\n - [JSON representation](#KeyEvent.SCHEMA_REPRESENTATION)\n- [CountingMethod](#CountingMethod)\n- [DefaultValue](#DefaultValue)\n - [JSON representation](#DefaultValue.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: KeyEvent\n------------------\n\nA key 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/v1beta/properties.keyEvents#CountingMethod), \"defaultValue\": { object (/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents#DefaultValue) } } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{keyEvent} |\n| `eventName` | `string` Immutable. The event name for this key event. Examples: 'click', 'purchase' |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time when this key 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 to true, this event can be deleted. |\n| `custom` | `boolean` Output only. If set to true, this key event refers to a custom event. If set to false, this key 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 key events that may be created per property. |\n| `countingMethod` | `enum (`[CountingMethod](/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents#CountingMethod)`)` Required. The method by which Key Events will be counted across multiple events within a session. |\n| `defaultValue` | `object (`[DefaultValue](/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents#DefaultValue)`)` Optional. Defines a default value/currency for a key event. |\n\nCountingMethod\n--------------\n\nThe method by which Key Events will be counted across multiple events within a session.\n\n| Enums ||\n|-------------------------------|--------------------------------------------------------------------------------|\n| `COUNTING_METHOD_UNSPECIFIED` | Counting method not specified. |\n| `ONCE_PER_EVENT` | Each Event instance is considered a Key Event. |\n| `ONCE_PER_SESSION` | An Event instance is considered a Key Event at most once per session per user. |\n\nDefaultValue\n------------\n\nDefines a default value/currency for a key event.\n\n| JSON representation |\n|------------------------------------------------------------|\n| ``` { \"numericValue\": number, \"currencyCode\": string } ``` |\n\n| Fields ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `numericValue` | `number` Required. This will be used to populate the \"value\" parameter for all occurrences of this Key Event (specified by eventName) where that parameter is unset. |\n| `currencyCode` | `string` Required. When an occurrence of this Key Event (specified by 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/v1beta/properties.keyEvents/create) | Creates a Key Event. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents/delete) | Deletes a Key Event. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents/get) | Retrieve a single Key Event. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents/list) | Returns a list of Key Events in the specified parent property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1beta/properties.keyEvents/patch) | Updates a Key Event. |"]]