Google Analytics için MCP sunucusunu deneyin.
GitHub'dan yükleyin ve daha fazla bilgi için
duyuruyu inceleyin.
REST Resource: properties.keyEvents
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: KeyEvent
Google Analytics mülkünde önemli bir etkinlik.
JSON gösterimi |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (CountingMethod ),
"defaultValue": {
object (DefaultValue )
}
} |
Alanlar |
name |
string
Yalnızca çıkış. Bu önemli etkinliğin kaynak adı. Biçim: properties/{property}/keyEvents/{keyEvent}
|
eventName |
string
Değişmez. Bu önemli etkinliğin etkinlik adı. Örnekler: "tıklama", "satın alma"
|
createTime |
string (Timestamp format)
Yalnızca çıkış. Bu önemli etkinliğin mülkte oluşturulduğu zaman. Oluşturulan çıktının her zaman Z normalleştirileceği ve 0, 3, 6 veya 9 kesirli basamak kullanacağı RFC 3339'u kullanır. "Z" dışındaki ofsetler de kabul edilir. Örnekler: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" veya "2014-10-02T15:01:23+05:30" .
|
deletable |
boolean
Yalnızca çıkış. Doğru değerine ayarlanırsa bu etkinlik silinebilir.
|
custom |
boolean
Yalnızca çıkış. Doğru değerine ayarlanırsa bu önemli etkinlik özel bir etkinliği ifade eder. Yanlış olarak ayarlanırsa bu önemli etkinlik, GA'daki varsayılan bir etkinliği ifade eder. Varsayılan etkinliklerin GA'da genellikle özel bir anlamı vardır. Varsayılan etkinlikler genellikle GA sistemi tarafından sizin için oluşturulur ancak bazı durumlarda mülk yöneticileri tarafından da oluşturulabilir. Özel etkinlikler, mülk başına oluşturulabilecek maksimum özel önemli etkinlik sayısına dahil edilir.
|
countingMethod |
enum (CountingMethod )
Zorunlu. Önemli etkinliklerin bir oturumdaki birden fazla etkinlikte sayılacağı yöntem.
|
defaultValue |
object (DefaultValue )
İsteğe bağlı. Bir önemli etkinlik için varsayılan değer/para birimi tanımlar.
|
CountingMethod
Önemli etkinliklerin bir oturumdaki birden fazla etkinlikte sayılacağı yöntem.
Sıralamalar |
COUNTING_METHOD_UNSPECIFIED |
Sayma yöntemi belirtilmemiş. |
ONCE_PER_EVENT |
Her etkinlik örneği önemli etkinlik olarak kabul edilir. |
ONCE_PER_SESSION |
Bir etkinlik örneği, kullanıcı başına oturum başına en fazla bir kez önemli etkinlik olarak kabul edilir. |
DefaultValue
Bir önemli etkinlik için varsayılan değer/para birimi tanımlar.
JSON gösterimi |
{
"numericValue": number,
"currencyCode": string
} |
Alanlar |
numericValue |
number
Zorunlu. Bu parametre, bu önemli etkinliğin (eventName ile belirtilir) "value" parametresinin ayarlanmadığı tüm örnekleri için "value" parametresini doldurmak amacıyla kullanılır.
|
currencyCode |
string
Zorunlu. Bu önemli etkinliğin (eventName ile belirtilir) bir gerçekleşmesinde ayarlanmış bir para birimi yoksa bu para birimi varsayılan olarak uygulanır. ISO 4217 para birimi kodu biçiminde olmalıdır. Daha fazla bilgi için https://en.wikipedia.org/wiki/ISO_4217 adresine bakın.
|
Yöntemler |
|
Önemli etkinlik oluşturur. |
|
Önemli bir etkinliği siler. |
|
Tek bir önemli etkinliği alma. |
|
Belirtilen üst mülkte önemli etkinliklerin listesini döndürür. |
|
Önemli bir etkinliği günceller. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-26 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-26 UTC."],[[["\u003cp\u003eKey Events are actions or interactions within a Google Analytics property that can be tracked and analyzed, with options for how they are counted during a session.\u003c/p\u003e\n"],["\u003cp\u003eYou can define a default numeric value and currency for a Key Event to automatically populate these parameters for instances where they are not explicitly set.\u003c/p\u003e\n"],["\u003cp\u003eThere are methods available to create, retrieve, update, and delete Key Events within a property via the API.\u003c/p\u003e\n"],["\u003cp\u003eKey Events can be either custom, defined by property admins, or default, with pre-defined meanings within Google Analytics.\u003c/p\u003e\n"]]],["Key Events in Google Analytics are defined by an event name and can be associated with a counting method (once per event or session). Each Key Event includes attributes like its creation time, custom status, and deletable status. They have optional default values, consisting of a numeric value and currency code. Key Events can be created, deleted, retrieved, listed, and updated using provided methods. The resource includes JSON schema for the data structure.\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/v1alpha/properties.keyEvents#CountingMethod), \"defaultValue\": { object (/analytics/devguides/config/admin/v1/rest/v1alpha/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/v1alpha/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/v1alpha/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/v1alpha/properties.keyEvents/create) | Creates a Key Event. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/delete) | Deletes a Key Event. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/get) | Retrieve a single Key Event. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/list) | Returns a list of Key Events in the specified parent property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/patch) | Updates a Key Event. |"]]