جرِّب خادم MCP لخدمة "إحصاءات Google". يمكنك تثبيت التطبيق من
GitHub والاطّلاع على
الإعلان لمعرفة المزيد من التفاصيل.
REST Resource: properties.conversionEvents
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المرجع: ConversionEvent
حدث إحالة ناجحة في موقع على "إحصاءات Google"
الحقول |
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
النتائج فقط. في حال ضبطها على "صحيح"، يشير حدث الإحالة الناجحة هذا إلى حدث مخصّص. في حال ضبطه على false، يشير حدث الإحالة الناجحة هذا إلى حدث تلقائي في "إحصاءات Google". عادةً ما يكون للأحداث التلقائية معنى خاصًا في "إحصاءات Google". وعادةً ما ينشئ نظام "إحصاءات Google" الأحداث التلقائية نيابةً عنك، ولكن في بعض الحالات يمكن أن ينشئها مشرفي الموقع. يتم احتساب الأحداث المخصّصة ضمن الحدّ الأقصى لعدد أحداث الإحالات الناجحة المخصّصة التي يمكن إنشاؤها لكلّ موقع.
|
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 بدلاً منها. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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. |"]]