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\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. |"]]