כדאי לנסות את שרת ה-MCP ל-Google Analytics. אפשר להתקין מ-
GitHub, ולקרוא את
ההודעה לפרטים נוספים.
REST Resource: properties.keyEvents
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
משאב: KeyEvent
אירוע מרכזי בנכס Google Analytics.
| ייצוג ב-JSON |
{
"name": string,
"eventName": string,
"createTime": string,
"deletable": boolean,
"custom": boolean,
"countingMethod": enum (CountingMethod),
"defaultValue": {
object (DefaultValue)
}
} |
| שדות |
name |
string
פלט בלבד. שם המשאב של האירוע המרכזי הזה. פורמט: properties/{property}/keyEvents/{keyEvent}
|
eventName |
string
לא ניתן לשינוי. שם האירוע של האירוע המרכזי הזה. דוגמאות: 'click', 'purchase'
|
createTime |
string (Timestamp format)
פלט בלבד. המועד שבו האירוע המרכזי הזה נוצר בנכס. הפורמט הזה משתמש ב-RFC 3339, שבו הפלט שנוצר תמיד יהיה מנורמלי לפי Z וישמש בספרות עשרוניות של 0, 3, 6 או 9. אפשר להשתמש גם בשינויים (offsets) אחרים מלבד 'Z'. דוגמאות: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" או "2014-10-02T15:01:23+05:30".
|
deletable |
boolean
פלט בלבד. אם הערך מוגדר כ-True, אפשר למחוק את האירוע הזה.
|
custom |
boolean
פלט בלבד. אם הערך מוגדר כ-true, האירוע המרכזי הזה מתייחס לאירוע מותאם אישית. אם הערך מוגדר כ-false, האירוע המרכזי הזה מתייחס לאירוע ברירת מחדל ב-GA. בדרך כלל, לאירועי ברירת מחדל יש משמעות מיוחדת ב-GA. בדרך כלל מערכת GA יוצרת בשבילכם אירועי ברירת מחדל, אבל במקרים מסוימים אדמינים של נכסים יכולים ליצור אותם. אירועים מותאמים אישית נספרים במסגרת המספר המקסימלי של אירועים מרכזיים בהתאמה אישית שניתן ליצור בכל נכס.
|
countingMethod |
enum (CountingMethod)
חובה. השיטה שבה אירועים מרכזיים ייספרו במספר אירועים במהלך סשן.
|
defaultValue |
object (DefaultValue)
אופציונלי. הגדרת ערך ברירת מחדל או מטבע ברירת מחדל לאירוע מרכזי.
|
CountingMethod
השיטה שבה אירועים מרכזיים ייספרו במספר אירועים במהלך סשן.
| טיפוסים בני מנייה (enum) |
COUNTING_METHOD_UNSPECIFIED |
לא צוינה שיטת הספירה. |
ONCE_PER_EVENT |
כל מופע של אירוע נחשב לאירוע מרכזי. |
ONCE_PER_SESSION |
מופע של אירוע נחשב לאירוע מרכזי לכל היותר פעם אחת לכל סשן לכל משתמש. |
DefaultValue
הגדרת ערך ברירת מחדל או מטבע ברירת מחדל לאירוע מרכזי.
| ייצוג ב-JSON |
{
"numericValue": number,
"currencyCode": string
} |
| שדות |
numericValue |
number
חובה. הפרמטר הזה ישמש לאכלוס הפרמטר 'value' בכל המופעים של האירוע המרכזי הזה (שצוין על ידי eventName) שבהם הפרמטר הזה לא מוגדר.
|
currencyCode |
string
חובה. אם לאירוע מרכזי מסוים (שצוין באמצעות eventName) אין מטבע מוגדר, המטבע הזה יוחל כברירת המחדל. חייב להיות בפורמט של קוד מטבע לפי תקן ISO 4217. מידע נוסף זמין בכתובת https://en.wikipedia.org/wiki/ISO_4217.
|
Methods |
|
|
יצירת אירוע מרכזי. |
|
|
מחיקה של אירוע מרכזי. |
|
|
אחזור של אירוע מרכזי יחיד. |
|
|
הפונקציה מחזירה רשימה של אירועים מרכזיים בנכס ההורה שצוין. |
|
|
עדכון של אירוע מרכזי. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eKey Events are actions or interactions within a Google Analytics property that can be tracked and analyzed, with options for how they are counted during a session.\u003c/p\u003e\n"],["\u003cp\u003eYou can define a default numeric value and currency for a Key Event to automatically populate these parameters for instances where they are not explicitly set.\u003c/p\u003e\n"],["\u003cp\u003eThere are methods available to create, retrieve, update, and delete Key Events within a property via the API.\u003c/p\u003e\n"],["\u003cp\u003eKey Events can be either custom, defined by property admins, or default, with pre-defined meanings within Google Analytics.\u003c/p\u003e\n"]]],["Key Events in Google Analytics are defined by an event name and can be associated with a counting method (once per event or session). Each Key Event includes attributes like its creation time, custom status, and deletable status. They have optional default values, consisting of a numeric value and currency code. Key Events can be created, deleted, retrieved, listed, and updated using provided methods. The resource includes JSON schema for the data structure.\n"],null,["# REST Resource: properties.keyEvents\n\n- [Resource: KeyEvent](#KeyEvent)\n - [JSON representation](#KeyEvent.SCHEMA_REPRESENTATION)\n- [CountingMethod](#CountingMethod)\n- [DefaultValue](#DefaultValue)\n - [JSON representation](#DefaultValue.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: KeyEvent\n------------------\n\nA key 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.keyEvents#CountingMethod), \"defaultValue\": { object (/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents#DefaultValue) } } ``` |\n\n| Fields ||\n|------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. Resource name of this key event. Format: properties/{property}/keyEvents/{keyEvent} |\n| `eventName` | `string` Immutable. The event name for this key event. Examples: 'click', 'purchase' |\n| `createTime` | `string (`[Timestamp](https://protobuf.dev/reference/protobuf/google.protobuf/#timestamp)` format)` Output only. Time when this key 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 to true, this event can be deleted. |\n| `custom` | `boolean` Output only. If set to true, this key event refers to a custom event. If set to false, this key 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 key events that may be created per property. |\n| `countingMethod` | `enum (`[CountingMethod](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents#CountingMethod)`)` Required. The method by which Key Events will be counted across multiple events within a session. |\n| `defaultValue` | `object (`[DefaultValue](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents#DefaultValue)`)` Optional. Defines a default value/currency for a key event. |\n\nCountingMethod\n--------------\n\nThe method by which Key Events will be counted across multiple events within a session.\n\n| Enums ||\n|-------------------------------|--------------------------------------------------------------------------------|\n| `COUNTING_METHOD_UNSPECIFIED` | Counting method not specified. |\n| `ONCE_PER_EVENT` | Each Event instance is considered a Key Event. |\n| `ONCE_PER_SESSION` | An Event instance is considered a Key Event at most once per session per user. |\n\nDefaultValue\n------------\n\nDefines a default value/currency for a key event.\n\n| JSON representation |\n|------------------------------------------------------------|\n| ``` { \"numericValue\": number, \"currencyCode\": string } ``` |\n\n| Fields ||\n|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `numericValue` | `number` Required. This will be used to populate the \"value\" parameter for all occurrences of this Key Event (specified by eventName) where that parameter is unset. |\n| `currencyCode` | `string` Required. When an occurrence of this Key Event (specified by 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.keyEvents/create) | Creates a Key Event. |\n| ### [delete](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/delete) | Deletes a Key Event. |\n| ### [get](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/get) | Retrieve a single Key Event. |\n| ### [list](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/list) | Returns a list of Key Events in the specified parent property. |\n| ### [patch](/analytics/devguides/config/admin/v1/rest/v1alpha/properties.keyEvents/patch) | Updates a Key Event. |"]]
