試用 Google Analytics 的 MCP 伺服器。從
GitHub 安裝,詳情請參閱
公告。
REST Resource: properties.conversionEvents
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:ConversionEvent
Google Analytics 資源中的轉換事件。
欄位 |
name |
string
僅供輸出。這個轉換事件的資源名稱。格式:properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
不可變動。這個轉換事件的事件名稱。例如:「click」、「purchase」
|
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 。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\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. |"]]