생성된 출력은 항상 Z-정규화되고 소수점 이하 자릿수가 0, 3, 6 또는 9인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
deletable
boolean
출력 전용입니다. 이 속성을 설정하면 현재 conversionEvents.delete를 사용하여 이 이벤트를 삭제할 수 있습니다.
custom
boolean
출력 전용입니다. true로 설정하면 이 전환 이벤트가 맞춤 이벤트를 참조합니다. false로 설정하면 이 전환 이벤트는 GA의 기본 이벤트를 참조합니다. 기본 이벤트는 일반적으로 GA에서 특별한 의미를 갖습니다. 기본 이벤트는 일반적으로 GA 시스템에서 자동으로 생성되지만 경우에 따라 속성 관리자가 만들 수도 있습니다. 맞춤 이벤트는 속성당 만들 수 있는 최대 맞춤 전환 이벤트 수에 포함됩니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 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. |"]]
