Wypróbuj serwer MCP w Google Analytics. Zainstaluj go z
GitHub. Więcej informacji znajdziesz w
ogłoszeniu.
REST Resource: properties.conversionEvents
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: ConversionEvent
Zdarzenie konwersji w usłudze w Google Analytics.
Pola |
name |
string
Tylko dane wyjściowe. Nazwa zasobu tego zdarzenia konwersji. Format: usługi/{usługa}/conversionEvents/{conversionEvent}
|
eventName |
string
Niezmienna. Nazwa zdarzenia konwersji. Przykłady: „kliknięcie”, „zakup”.
|
createTime |
string (Timestamp format)
Tylko dane wyjściowe. Czas utworzenia tego zdarzenia konwersji w usłudze. Używa standardu RFC 3339, w którym wygenerowany wynik jest zawsze znormalizowany według normy Z i zawiera 0, 3, 6 lub 9 cyfr ułamkowych. Dopuszczalne są też przesunięcia inne niż „Z”. Przykłady: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" lub "2014-10-02T15:01:23+05:30" .
|
deletable |
boolean
Tylko dane wyjściowe. Jeśli jest ustawione, to zdarzenie można obecnie usunąć za pomocą metody conversionEvents.delete.
|
custom |
boolean
Tylko dane wyjściowe. Jeśli ma wartość Prawda, to zdarzenie konwersji odnosi się do zdarzenia niestandardowego. Jeśli ustawisz wartość false, to zdarzenie konwersji będzie się odnosić do zdarzenia domyślnego w GA. Zdarzenia domyślne mają w GA specjalne znaczenie. Zdarzenia domyślne są zwykle tworzone przez system GA, ale w niektórych przypadkach mogą być tworzone przez administratorów usług. Zdarzenia niestandardowe wliczają się do maksymalnej liczby niestandardowych zdarzeń konwersji, które można utworzyć w poszczególnych usługach.
|
countingMethod |
enum (ConversionCountingMethod )
Opcjonalnie: Metoda zliczania konwersji w ramach wielu zdarzeń w sesji. Jeśli nie podasz tej wartości, zostanie ona ustawiona na ONCE_PER_EVENT .
|
defaultConversionValue |
object (DefaultConversionValue )
Opcjonalnie: Określa domyślną wartość lub walutę zdarzenia konwersji.
|
ConversionCountingMethod
Metoda zliczania konwersji w ramach wielu zdarzeń w sesji.
Wartości w polu enum |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
Metoda zliczania nie została określona. |
ONCE_PER_EVENT |
Każde wystąpienie zdarzenia jest uznawane za konwersję. |
ONCE_PER_SESSION |
Wystąpienie zdarzenia jest uznawane za konwersję maksymalnie raz na sesję na użytkownika. |
DefaultConversionValue
Określa domyślną wartość lub walutę zdarzenia konwersji. Musisz podać wartość i walutę.
Zapis JSON |
{
"value": number,
"currencyCode": string
} |
Pola |
value |
number
Ta wartość będzie używana do wypełniania wartości wszystkich konwersji zdarzenia eventName, w których parametr „value” nie jest ustawiony.
|
currencyCode |
string
Jeśli zdarzenie konwersji o nazwie eventName nie ma ustawionej waluty, zostanie zastosowana domyślna waluta. Musi być w formacie kodu waluty ISO 4217. Więcej informacji znajdziesz na stronie https://en.wikipedia.org/wiki/ISO_4217.
|
Metody |
create (deprecated)
|
Wycofane: użyj w zastępstwie tego CreateKeyEvent . |
delete (deprecated)
|
Wycofane: użyj w zastępstwie tego DeleteKeyEvent . |
get (deprecated)
|
Wycofane: użyj w zastępstwie tego GetKeyEvent . |
list (deprecated)
|
Wycofane: użyj w zastępstwie tego ListKeyEvents . |
patch (deprecated)
|
Wycofane: użyj w zastępstwie tego UpdateKeyEvent . |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-26 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]