Try the MCP server for Google Analytics. Install from
GitHub, and see the
announcement for more details.
REST Resource: properties.conversionEvents
Stay organized with collections
Save and categorize content based on your preferences.
Resource: ConversionEvent
A conversion event in a Google Analytics property.
JSON representation |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (ConversionCountingMethod ),
"defaultConversionValue": {
object (DefaultConversionValue )
}
} |
Fields |
name |
string
Output only. Resource name of this conversion event. Format: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
Immutable. The event name for this conversion event. Examples: 'click', 'purchase'
|
createTime |
string (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" .
|
deletable |
boolean
Output only. If set, this event can currently be deleted with conversionEvents.delete.
|
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.
|
countingMethod |
enum (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 .
|
defaultConversionValue |
object (DefaultConversionValue )
Optional. Defines a default value/currency for a conversion event.
|
ConversionCountingMethod
The method by which conversions will be counted across multiple events within a session.
Enums |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
Counting method not specified. |
ONCE_PER_EVENT |
Each Event instance is considered a Conversion. |
ONCE_PER_SESSION |
An Event instance is considered a Conversion at most once per session per user. |
DefaultConversionValue
Defines a default value/currency for a conversion event. Both value and currency must be provided.
JSON representation |
{
"value": number,
"currencyCode": string
} |
Fields |
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.
|
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 https://en.wikipedia.org/wiki/ISO_4217 for more information.
|
Methods |
create (deprecated)
|
Deprecated: Use CreateKeyEvent instead. |
delete (deprecated)
|
Deprecated: Use DeleteKeyEvent instead. |
get (deprecated)
|
Deprecated: Use GetKeyEvent instead. |
list (deprecated)
|
Deprecated: Use ListKeyEvents instead. |
patch (deprecated)
|
Deprecated: Use UpdateKeyEvent instead. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-02 UTC.
[null,null,["Last updated 2025-04-02 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. |"]]