MCP-Server für Google Analytics ausprobieren Installieren Sie das Tool über
GitHub. Weitere Informationen finden Sie in der
Ankündigung.
REST Resource: properties.conversionEvents
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: ConversionEvent
Ein Conversion-Ereignis in einer Google Analytics-Property.
JSON-Darstellung |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (ConversionCountingMethod ),
"defaultConversionValue": {
object (DefaultConversionValue )
}
} |
Felder |
name |
string
Nur Ausgabe. Ressourcenname dieses Conversion-Ereignisses. Format: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
Nicht veränderbar. Der Ereignisname für dieses Conversion-Ereignis. Beispiele: „click“ (Klick) und „purchase“ (Kauf)
|
createTime |
string (Timestamp format)
Nur Ausgabe. Zeitpunkt, zu dem dieses Conversion-Ereignis in der Property erstellt wurde. Es wird RFC 3339 verwendet, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Glieder mit Dezimalstellen enthält. Andere Achsenbezeichnungen als „Z“ sind ebenfalls zulässig. Beispiele: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30" .
|
deletable |
boolean
Nur Ausgabe. Wenn dieses Ereignis festgelegt ist, kann es derzeit mit „conversionEvents.delete“ gelöscht werden.
|
custom |
boolean
Nur Ausgabe. Wenn diese Option auf „wahr“ gesetzt ist, bezieht sich dieses Conversion-Ereignis auf ein benutzerdefiniertes Ereignis. Wenn „false“ festgelegt ist, bezieht sich dieses Conversion-Ereignis auf ein Standardereignis in Google Analytics. Standardereignisse haben in Google Analytics in der Regel eine besondere Bedeutung. Sie werden in der Regel vom Google Analytics-System für Sie erstellt, können aber in einigen Fällen auch von Property-Administratoren erstellt werden. Benutzerdefinierte Ereignisse werden auf die maximale Anzahl von benutzerdefinierten Conversion-Ereignissen angerechnet, die pro Property erstellt werden können.
|
countingMethod |
enum (ConversionCountingMethod )
Optional. Die Methode, mit der Conversions über mehrere Ereignisse innerhalb einer Sitzung gezählt werden. Wenn dieser Wert nicht angegeben wird, wird er auf ONCE_PER_EVENT gesetzt.
|
defaultConversionValue |
object (DefaultConversionValue )
Optional. Hiermit wird ein Standardwert/eine Standardwährung für ein Conversion-Ereignis definiert.
|
ConversionCountingMethod
Die Methode, mit der Conversions über mehrere Ereignisse innerhalb einer Sitzung gezählt werden.
Enums |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
Zählmethode nicht angegeben. |
ONCE_PER_EVENT |
Jede Ereignisinstanz wird als Conversion betrachtet. |
ONCE_PER_SESSION |
Eine Ereignisinstanz wird höchstens einmal pro Sitzung und Nutzer als Conversion gezählt. |
DefaultConversionValue
Hiermit wird ein Standardwert/eine Standardwährung für ein Conversion-Ereignis definiert. Sowohl der Wert als auch die Währung müssen angegeben werden.
JSON-Darstellung |
{
"value": number,
"currencyCode": string
} |
Felder |
value |
number
Dieser Wert wird verwendet, um den Wert für alle Conversions des angegebenen Ereignisnamens auszufüllen, bei denen der Ereignisparameter „value“ nicht festgelegt ist.
|
currencyCode |
string
Wenn für ein Conversion-Ereignis für diesen Ereignisnamen keine Währung festgelegt ist, wird diese Währung als Standard verwendet. Muss im Format des ISO 4217-Währungscodes angegeben werden. Weitere Informationen finden Sie unter https://en.wikipedia.org/wiki/ISO_4217.
|
Methoden |
create (deprecated)
|
Verworfen. Verwenden Sie stattdessen CreateKeyEvent . |
delete (deprecated)
|
Verworfen. Verwenden Sie stattdessen DeleteKeyEvent . |
get (deprecated)
|
Verworfen. Verwenden Sie stattdessen GetKeyEvent . |
list (deprecated)
|
Verworfen. Verwenden Sie stattdessen ListKeyEvents . |
patch (deprecated)
|
Verworfen. Verwenden Sie stattdessen UpdateKeyEvent . |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]