试用 Google Analytics 的 MCP 服务器。从
GitHub 安装,并参阅
公告了解详情。
REST Resource: properties.conversionEvents
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
资源:ConversionEvent
Google Analytics 媒体资源中的转化事件。
字段 |
name |
string
仅限输出。此转化事件的资源名称。格式:properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
不可变。此转化事件的事件名称。示例:“点击”“购买”
|
createTime |
string (Timestamp format)
仅限输出。在媒体资源中创建此转化事件的时间。 采用 RFC 3339 标准,生成的输出将始终在末尾带 Z,并使用 0、3、6 或 9 个小数位。不带“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
此值将用于为指定 eventName 的所有转化填充值,前提是事件“value”参数未设置。
|
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 。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\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. |"]]