Essayez le serveur MCP pour Google Analytics. Installez-le depuis
GitHub et consultez l'
annonce pour en savoir plus.
REST Resource: properties.conversionEvents
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource: ConversionEvent
Événement de conversion dans une propriété Google Analytics.
Représentation JSON |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (ConversionCountingMethod ),
"defaultConversionValue": {
object (DefaultConversionValue )
}
} |
Champs |
name |
string
Uniquement en sortie. Nom de la ressource de cet événement de conversion. Format: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
Immuable. Nom de l'événement de conversion. Exemples: "clic", "achat"
|
createTime |
string (Timestamp format)
Uniquement en sortie. Heure à laquelle cet événement de conversion a été créé dans la propriété. Utilise la norme RFC 3339, où la sortie générée est toujours normalisée avec le suffixe Z et utilise 0, 3, 6 ou 9 chiffres décimaux. Les décalages autres que "Z" sont également acceptés. Exemples: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30" .
|
deletable |
boolean
Uniquement en sortie. Si cette valeur est définie, cet événement peut actuellement être supprimé avec conversionEvents.delete.
|
custom |
boolean
Uniquement en sortie. Si elle est définie sur "True", cet événement de conversion fait référence à un événement personnalisé. Si la valeur est définie sur "false", cet événement de conversion fait référence à un événement par défaut dans GA. Les événements par défaut ont généralement une signification particulière dans GA. Ils sont généralement créés par le système GA, mais peuvent parfois être créés par les administrateurs de la propriété. Les événements personnalisés sont comptabilisés dans le nombre maximal d'événements de conversion personnalisés pouvant être créés par propriété.
|
countingMethod |
enum (ConversionCountingMethod )
Facultatif. Méthode de comptabilisation des conversions pour plusieurs événements au cours d'une session. Si cette valeur n'est pas fournie, elle sera définie sur ONCE_PER_EVENT .
|
defaultConversionValue |
object (DefaultConversionValue )
Facultatif. Définit une valeur/une devise par défaut pour un événement de conversion.
|
ConversionCountingMethod
Méthode de comptabilisation des conversions pour plusieurs événements au cours d'une session.
Enums |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
La méthode de comptabilisation n'est pas spécifiée. |
ONCE_PER_EVENT |
Chaque instance d'événement est considérée comme une conversion. |
ONCE_PER_SESSION |
Une instance d'événement est considérée comme une conversion au maximum une fois par session et par utilisateur. |
DefaultConversionValue
Définit une valeur/une devise par défaut pour un événement de conversion. Vous devez indiquer la valeur et la devise.
Représentation JSON |
{
"value": number,
"currencyCode": string
} |
Champs |
value |
number
Cette valeur sera utilisée pour renseigner la valeur de toutes les conversions de l'eventName spécifié lorsque le paramètre "value" de l'événement n'est pas défini.
|
currencyCode |
string
Lorsqu'un événement de conversion pour cet eventName n'a pas de devise définie, cette devise est appliquée par défaut. Doit être au format de code de devise ISO 4217. Pour en savoir plus, consultez https://en.wikipedia.org/wiki/ISO_4217.
|
Méthodes |
create (deprecated)
|
Obsolète: utilisez CreateKeyEvent à la place. |
delete (deprecated)
|
Obsolète: utilisez DeleteKeyEvent à la place. |
get (deprecated)
|
Obsolète: utilisez GetKeyEvent à la place. |
list (deprecated)
|
Obsolète: utilisez ListKeyEvents à la place. |
patch (deprecated)
|
Obsolète: utilisez UpdateKeyEvent à la place. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/26 (UTC).
[null,null,["Dernière mise à jour le 2025/07/26 (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. |"]]