Google 애널리틱스용 MCP 서버를 사용해 보세요.
GitHub에서 설치하고
공지사항에서 자세한 내용을 확인하세요.
REST Resource: properties.conversionEvents
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
리소스: ConversionEvent
Google 애널리틱스 속성의 전환 이벤트입니다.
필드 |
name |
string
출력 전용입니다. 이 전환 이벤트의 리소스 이름입니다. 형식: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
변경할 수 없습니다. 이 전환 이벤트의 이벤트 이름입니다. 예: '클릭', '구매'
|
createTime |
string (Timestamp format)
출력 전용입니다. 속성에서 이 전환 이벤트가 생성된 시간입니다. 생성된 출력은 항상 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 시스템에서 자동으로 생성되지만 경우에 따라 속성 관리자가 만들 수도 있습니다. 맞춤 이벤트는 속성당 만들 수 있는 최대 맞춤 전환 이벤트 수에 포함됩니다.
|
countingMethod |
enum (ConversionCountingMethod )
선택사항입니다. 세션 내 여러 이벤트에서 전환을 집계하는 방법입니다. 이 값을 제공하지 않으면 ONCE_PER_EVENT 로 설정됩니다.
|
defaultConversionValue |
object (DefaultConversionValue )
선택사항입니다. 전환 이벤트의 기본값/통화를 정의합니다.
|
ConversionCountingMethod
세션 내 여러 이벤트에서 전환을 집계하는 방법입니다.
열거형 |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
집계 방법이 지정되지 않았습니다. |
ONCE_PER_EVENT |
각 이벤트 인스턴스는 전환으로 간주됩니다. |
ONCE_PER_SESSION |
이벤트 인스턴스는 사용자당 세션당 최대 한 번 전환으로 간주됩니다. |
DefaultConversionValue
전환 이벤트의 기본값/통화를 정의합니다. 값과 통화를 모두 제공해야 합니다.
JSON 표현 |
{
"value": number,
"currencyCode": string
} |
필드 |
value |
number
이 값은 이벤트 'value' 매개변수가 설정되지 않은 지정된 eventName의 모든 전환에 대한 값을 채우는 데 사용됩니다.
|
currencyCode |
string
이 eventName의 전환 이벤트에 설정된 통화가 없는 경우 이 통화가 기본값으로 적용됩니다. ISO 4217 통화 코드 형식이어야 합니다. 자세한 내용은 https://en.wikipedia.org/wiki/ISO_4217을 참고하세요.
|
메서드 |
create (deprecated)
|
지원 중단됨: 대신 CreateKeyEvent 를 사용하세요. |
delete (deprecated)
|
지원 중단됨: 대신 DeleteKeyEvent 를 사용하세요. |
get (deprecated)
|
지원 중단됨: 대신 GetKeyEvent 를 사용하세요. |
list (deprecated)
|
지원 중단됨: 대신 ListKeyEvents 를 사용하세요. |
patch (deprecated)
|
지원 중단됨: 대신 UpdateKeyEvent 를 사용하세요. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-26(UTC)
[null,null,["최종 업데이트: 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. |"]]