مطلوب. اسم الحقل الذي تتم مقارنته بالشرط. إذا كانت قيمة 'eventName' محدد سيتم تطبيق هذا الشرط على اسم الحدث. وبخلاف ذلك، سيتم تطبيق الشرط على معلَمة بالاسم المحدّد.
مطلوب. القيمة التي تتم مقارنتها لهذا الشرط. قد يؤدي تنفيذ بيئة التشغيل إلى تنفيذ نوع معيّن من هذه القيمة لتقييم هذا الشرط استنادًا إلى نوع قيمة المَعلمة.
negated
boolean
يجب إلغاء نتيجة المقارنة أو لا. على سبيل المثال، إذا كانت negated صحيحة، فإن "تساوي" ستعمل المقارنات على أنها "غير يساوي".
ComparisonType
نوع المقارنة لشرط المطابقة
عمليات التعداد
COMPARISON_TYPE_UNSPECIFIED
غير معروف
EQUALS
يساوي، حسّاس لحالة الأحرف
EQUALS_CASE_INSENSITIVE
يساوي، غير حساس لحالة الأحرف
CONTAINS
يحتوي على، حسّاس لحالة الأحرف
CONTAINS_CASE_INSENSITIVE
يحتوي على، غير حساس لحالة الأحرف
STARTS_WITH
تبدأ بـ، حسّاسة لحالة الأحرف
STARTS_WITH_CASE_INSENSITIVE
تبدأ بـ، غير حساسة لحالة الأحرف
ENDS_WITH
ينتهي بـ، حسّاس لحالة الأحرف
ENDS_WITH_CASE_INSENSITIVE
ينتهي بـ، غير حساس لحالة الأحرف
GREATER_THAN
أكبر من
GREATER_THAN_OR_EQUAL
أكبر من أو يساوي
LESS_THAN
أقل من
LESS_THAN_OR_EQUAL
أقل من أو يساوي
REGULAR_EXPRESSION
التعبير العادي. لا يمكن استخدامها إلا لمصادر بيانات الويب.
REGULAR_EXPRESSION_CASE_INSENSITIVE
تعبير عادي غير حساس لحالة الأحرف. لا يمكن استخدامها إلا لمصادر بيانات الويب.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eMatchingCondition defines criteria for when an Event Edit or Event Creation rule is applied, based on event properties.\u003c/p\u003e\n"],["\u003cp\u003eIt uses a comparison between a specified event field and a given value, with options for case sensitivity and negation.\u003c/p\u003e\n"],["\u003cp\u003eSupported comparison types include equality, containment, starts/ends with, greater/less than, and regular expressions (web streams only).\u003c/p\u003e\n"],["\u003cp\u003eThe condition can be applied to the event name or any event parameter, enabling flexible rule creation.\u003c/p\u003e\n"]]],["This describes a matching condition used in event rules, defined via a JSON object with `field`, `comparisonType`, `value`, and `negated`. The `field` specifies the parameter or 'eventName' for comparison. The `comparisonType` defines the comparison method, such as `EQUALS`, `CONTAINS`, or `GREATER_THAN`. The `value` is the comparison target, and `negated` inverts the comparison result. Available `comparisonType` options also include case-insensitive variants and regular expression matching.\n"],null,["# MatchingCondition\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [ComparisonType](#ComparisonType)\n\nDefines a condition for when an Event Edit or Event Creation rule applies to an event.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"field\": string, \"comparisonType\": enum (/analytics/devguides/config/admin/v1/rest/v1alpha/MatchingCondition#ComparisonType), \"value\": string, \"negated\": boolean } ``` |\n\n| Fields ||\n|------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `field` | `string` Required. The name of the field that is compared against for the condition. If 'eventName' is specified this condition will apply to the name of the event. Otherwise the condition will apply to a parameter with the specified name. This value cannot contain spaces. |\n| `comparisonType` | `enum (`[ComparisonType](/analytics/devguides/config/admin/v1/rest/v1alpha/MatchingCondition#ComparisonType)`)` Required. The type of comparison to be applied to the value. |\n| `value` | `string` Required. The value being compared against for this condition. The runtime implementation may perform type coercion of this value to evaluate this condition based on the type of the parameter value. |\n| `negated` | `boolean` Whether or not the result of the comparison should be negated. For example, if `negated` is true, then 'equals' comparisons would function as 'not equals'. |\n\nComparisonType\n--------------\n\nComparison type for matching condition\n\n| Enums ||\n|---------------------------------------|-----------------------------------------------------------------------|\n| `COMPARISON_TYPE_UNSPECIFIED` | Unknown |\n| `EQUALS` | Equals, case sensitive |\n| `EQUALS_CASE_INSENSITIVE` | Equals, case insensitive |\n| `CONTAINS` | Contains, case sensitive |\n| `CONTAINS_CASE_INSENSITIVE` | Contains, case insensitive |\n| `STARTS_WITH` | Starts with, case sensitive |\n| `STARTS_WITH_CASE_INSENSITIVE` | Starts with, case insensitive |\n| `ENDS_WITH` | Ends with, case sensitive |\n| `ENDS_WITH_CASE_INSENSITIVE` | Ends with, case insensitive |\n| `GREATER_THAN` | Greater than |\n| `GREATER_THAN_OR_EQUAL` | Greater than or equal |\n| `LESS_THAN` | Less than |\n| `LESS_THAN_OR_EQUAL` | Less than or equal |\n| `REGULAR_EXPRESSION` | regular expression. Only supported for web streams. |\n| `REGULAR_EXPRESSION_CASE_INSENSITIVE` | regular expression, case insensitive. Only supported for web streams. |"]]
