Teste o servidor MCP do Google Analytics. Instale no
GitHub e confira o
anúncio para mais detalhes.
REST Resource: properties.conversionEvents
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: ConversionEvent
Um evento de conversão em uma propriedade do Google Analytics.
Representação JSON |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (ConversionCountingMethod ),
"defaultConversionValue": {
object (DefaultConversionValue )
}
} |
Campos |
name |
string
Apenas saída. Nome do recurso desse evento de conversão. Formato: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
Imutável. O nome do evento de conversão. Exemplos: "click", "compra"
|
createTime |
string (Timestamp format)
Apenas saída. Horário em que esse evento de conversão foi criado na propriedade. Usa o RFC 3339, em que a saída gerada é sempre normalizada em Z e usa dígitos fracionários 0, 3, 6 ou 9. Deslocamentos diferentes de "Z" também são aceitos. Exemplos: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30" .
|
deletable |
boolean
Apenas saída. Se definido, esse evento pode ser excluído com conversionEvents.delete.
|
custom |
boolean
Apenas saída. Se definido como "true", esse evento de conversão se refere a um evento personalizado. Se definido como "false", esse evento de conversão se refere a um evento padrão no GA. Os eventos padrão geralmente têm um significado especial no GA. Eles são criados pelo sistema do GA, mas, em alguns casos, podem ser criados pelos administradores da propriedade. Os eventos personalizados contam para o número máximo de eventos de conversão personalizados que podem ser criados por propriedade.
|
countingMethod |
enum (ConversionCountingMethod )
Opcional. O método pelo qual as conversões são contabilizadas em vários eventos em uma sessão. Se esse valor não for fornecido, ele será definido como ONCE_PER_EVENT .
|
defaultConversionValue |
object (DefaultConversionValue )
Opcional. Define um valor/moeda padrão para um evento de conversão.
|
ConversionCountingMethod
O método pelo qual as conversões são contabilizadas em vários eventos em uma sessão.
Enums |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
O método de contagem não foi especificado. |
ONCE_PER_EVENT |
Cada instância de evento é considerada uma conversão. |
ONCE_PER_SESSION |
Uma instância de evento é considerada uma conversão no máximo uma vez por sessão e por usuário. |
DefaultConversionValue
Define um valor/moeda padrão para um evento de conversão. É necessário informar o valor e a moeda.
Representação JSON |
{
"value": number,
"currencyCode": string
} |
Campos |
value |
number
Esse valor será usado para preencher o valor de todas as conversões do eventName especificado em que o parâmetro "value" do evento não está definido.
|
currencyCode |
string
Quando um evento de conversão para esse eventName não tiver uma moeda definida, essa moeda será aplicada como padrão. Precisa estar no formato de código de moeda ISO 4217. Consulte https://en.wikipedia.org/wiki/ISO_4217 para mais informações.
|
Métodos |
create (deprecated)
|
Descontinuado: use CreateKeyEvent . |
delete (deprecated)
|
Descontinuado: use DeleteKeyEvent . |
get (deprecated)
|
Descontinuado: use GetKeyEvent . |
list (deprecated)
|
Descontinuado: use ListKeyEvents . |
patch (deprecated)
|
Descontinuado: use UpdateKeyEvent . |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-26 UTC.
[null,null,["Última atualização 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. |"]]