ลองใช้เซิร์ฟเวอร์ MCP สำหรับ Google Analytics ติดตั้งจาก
GitHub และดูรายละเอียดเพิ่มเติมได้ที่
ประกาศ
REST Resource: properties.conversionEvents
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
ทรัพยากร: ConversionEvent
เหตุการณ์ Conversion ในพร็อพเพอร์ตี้ Google Analytics
ช่อง |
name |
string
เอาต์พุตเท่านั้น ชื่อทรัพยากรของเหตุการณ์ Conversion นี้ รูปแบบ: properties/{property}/conversionEvents/{conversionEvent}
|
eventName |
string
เปลี่ยนแปลงไม่ได้ ชื่อเหตุการณ์สําหรับเหตุการณ์ Conversion นี้ ตัวอย่างเช่น "click", "purchase"
|
createTime |
string (Timestamp format)
เอาต์พุตเท่านั้น เวลาที่สร้างเหตุการณ์ Conversion นี้ในพร็อพเพอร์ตี้ ใช้ RFC 3339 ซึ่งเอาต์พุตที่สร้างขึ้นจะเป็นรูปแบบ Z-normalized เสมอ และใช้ตัวเลขทศนิยม 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
เอาต์พุตเท่านั้น หากตั้งค่าเป็น "จริง" เหตุการณ์ Conversion นี้จะหมายถึงเหตุการณ์ที่กําหนดเอง หากตั้งค่าเป็นเท็จ เหตุการณ์ Conversion นี้จะหมายถึงเหตุการณ์เริ่มต้นใน GA ซึ่งโดยปกติแล้วเหตุการณ์เริ่มต้นจะมีความหมายพิเศษใน GA โดยปกติแล้วระบบ GA จะสร้างเหตุการณ์เริ่มต้นให้คุณ แต่ในบางกรณีผู้ดูแลระบบพร็อพเพอร์ตี้อาจสร้างเหตุการณ์เริ่มต้นได้ เหตุการณ์ที่กําหนดเองจะนับรวมอยู่ในจํานวนสูงสุดของเหตุการณ์ Conversion ที่กําหนดเองซึ่งอาจสร้างขึ้นต่อพร็อพเพอร์ตี้
|
countingMethod |
enum (ConversionCountingMethod )
ไม่บังคับ วิธีการนับ Conversion ในหลายเหตุการณ์ภายในเซสชัน หากไม่ได้ระบุค่านี้ ระบบจะตั้งค่าเป็น ONCE_PER_EVENT
|
defaultConversionValue |
object (DefaultConversionValue )
ไม่บังคับ กําหนดมูลค่า/สกุลเงินเริ่มต้นสําหรับเหตุการณ์ Conversion
|
ConversionCountingMethod
วิธีการนับ Conversion ในหลายเหตุการณ์ภายในเซสชัน
Enum |
CONVERSION_COUNTING_METHOD_UNSPECIFIED |
ไม่ได้ระบุวิธีการนับ |
ONCE_PER_EVENT |
ระบบจะถือว่าอินสแตนซ์เหตุการณ์แต่ละรายการเป็น Conversion |
ONCE_PER_SESSION |
ระบบจะถือว่าอินสแตนซ์เหตุการณ์เป็น Conversion ไม่เกิน 1 ครั้งต่อเซสชันต่อผู้ใช้ |
DefaultConversionValue
กําหนดมูลค่า/สกุลเงินเริ่มต้นสําหรับเหตุการณ์ Conversion ต้องระบุทั้งค่าและสกุลเงิน
การแสดง JSON |
{
"value": number,
"currencyCode": string
} |
ช่อง |
value |
number
ระบบจะใช้ค่านี้เพื่อป้อนข้อมูลมูลค่าสําหรับ Conversion ทั้งหมดของ eventName ที่ระบุซึ่งไม่ได้ตั้งค่าพารามิเตอร์ "value" ของเหตุการณ์ไว้
|
currencyCode |
string
เมื่อเหตุการณ์ Conversion สําหรับชื่อเหตุการณ์นี้ไม่มีสกุลเงินที่กําหนดไว้ ระบบจะใช้สกุลเงินนี้เป็นค่าเริ่มต้น ต้องอยู่ในรูปแบบรหัสสกุลเงิน 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 Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-26 UTC
[null,null,["อัปเดตล่าสุด 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. |"]]