Google Analytics için MCP sunucusunu deneyin.
GitHub'dan yükleyin ve daha fazla bilgi için
duyuruyu inceleyin.
REST Resource: properties.conversionEvents
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: ConversionEvent
Google Analytics mülkünde bir dönüşüm etkinliği.
JSON gösterimi |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (ConversionCountingMethod ),
"defaultConversionValue": {
object (DefaultConversionValue )
}
} |
Alanlar |
name |
string
Yalnızca çıkış. Bu dönüşüm etkinliğinin kaynak adı. Biçim: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
Değişmez. Bu dönüşüm etkinliğinin etkinlik adı. Örnekler: "tıklama", "satın alma"
|
createTime |
string (Timestamp format)
Yalnızca çıkış. Bu dönüşüm etkinliğinin 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ış. Ayarlanmışsa bu etkinlik şu anda conversionEvents.delete ile silinebilir.
|
custom |
boolean
Yalnızca çıkış. Doğru olarak ayarlanırsa bu dönüşüm etkinliği özel bir etkinliği ifade eder. Yanlış olarak ayarlanırsa bu dönüşüm etkinliği, GA'daki bir varsayılan 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 dönüşüm etkinliği sayısına dahil edilir.
|
countingMethod |
enum (ConversionCountingMethod )
İsteğe bağlı. Dönüşümlerin bir oturumdaki birden fazla etkinlikte nasıl sayılacağını belirleyen yöntem. Bu değer sağlanmazsa ONCE_PER_EVENT olarak ayarlanır.
|
defaultConversionValue |
object (DefaultConversionValue )
İsteğe bağlı. Bir dönüşüm etkinliği için varsayılan değer/para birimi tanımlar.
|
ConversionCountingMethod
Dönüşümlerin bir oturumdaki birden fazla etkinlikte nasıl sayılacağını belirleyen yöntem.
Sıralamalar |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
Sayma yöntemi belirtilmemiş. |
ONCE_PER_EVENT |
Her etkinlik örneği bir dönüşüm olarak kabul edilir. |
ONCE_PER_SESSION |
Bir etkinlik örneği, kullanıcı başına oturum başına en fazla bir kez dönüşüm olarak kabul edilir. |
DefaultConversionValue
Bir dönüşüm etkinliği için varsayılan değer/para birimi tanımlar. Hem değer hem de para birimi sağlanmalıdır.
JSON gösterimi |
{
"value": number,
"currencyCode": string
} |
Alanlar |
value |
number
Bu değer, etkinlik "value" parametresinin ayarlanmadığı, belirtilen eventName değerinin tüm dönüşümleri için değeri doldurmak üzere kullanılır.
|
currencyCode |
string
Bu eventName için bir dönüşüm etkinliğinde ayarlanmış 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 |
create (deprecated)
|
Desteği sonlandırıldı: Bunun yerine CreateKeyEvent politikasını kullanın. |
delete (deprecated)
|
Desteği sonlandırıldı: Bunun yerine DeleteKeyEvent politikasını kullanın. |
get (deprecated)
|
Desteği sonlandırıldı: Bunun yerine GetKeyEvent politikasını kullanın. |
list (deprecated)
|
Desteği sonlandırıldı: Bunun yerine ListKeyEvents politikasını kullanın. |
patch (deprecated)
|
Desteği sonlandırıldı: Bunun yerine UpdateKeyEvent politikasını kullanın. |
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\u003eA Conversion Event resource in Google Analytics 4 represents actions like clicks or purchases, allowing you to track and analyze important user interactions.\u003c/p\u003e\n"],["\u003cp\u003eConversion events can be configured with a \u003ccode\u003ecountingMethod\u003c/code\u003e to specify how conversions are tallied during a user's session, such as counting each instance or only once per session.\u003c/p\u003e\n"],["\u003cp\u003eOptionally, a default value and currency can be assigned to a conversion event, automatically populating conversion data when the event's value parameter is not set.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage conversion events using methods like creating, deleting, retrieving, listing, and updating them within a Google Analytics property.\u003c/p\u003e\n"]]],["Conversion events, tracked in Google Analytics properties, capture user actions like 'click' or 'purchase'. Each event has attributes such as `name`, `eventName`, `createTime`, whether it's `deletable` and `custom`. The `countingMethod` determines how conversions are counted, either `ONCE_PER_EVENT` or `ONCE_PER_SESSION`. `DefaultConversionValue` sets a default `value` and `currencyCode` for conversions without these parameters. Lastly, the `create`, `delete`, `get`, `list`, and `patch` methods are deprecated in favor of newer `KeyEvent` alternatives.\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/v1beta/properties.conversionEvents#ConversionCountingMethod), \"defaultConversionValue\": { object (/analytics/devguides/config/admin/v1/rest/v1beta/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/v1beta/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/v1beta/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/v1beta/properties.conversionEvents/create)` ` **(deprecated)** | Deprecated: Use `CreateKeyEvent` instead. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1beta/properties.conversionEvents/delete)` ` **(deprecated)** | Deprecated: Use `DeleteKeyEvent` instead. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1beta/properties.conversionEvents/get)` ` **(deprecated)** | Deprecated: Use `GetKeyEvent` instead. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1beta/properties.conversionEvents/list)` ` **(deprecated)** | Deprecated: Use `ListKeyEvents` instead. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1beta/properties.conversionEvents/patch)` ` **(deprecated)** | Deprecated: Use `UpdateKeyEvent` instead. |"]]