مورد نیاز. نام فیلدی که با آن شرط مقایسه می شود. اگر "EventName" مشخص شده باشد، این شرط برای نام رویداد اعمال می شود. در غیر این صورت این شرط برای پارامتری با نام مشخص شده اعمال می شود.
مورد نیاز. نوع مقایسه ای که باید روی مقدار اعمال شود.
value
string
مورد نیاز. مقداری که برای این شرایط با آن مقایسه می شود. اجرای زمان اجرا ممکن است نوع اجبار این مقدار را برای ارزیابی این شرایط بر اساس نوع مقدار پارامتر انجام دهد.
negated
boolean
اینکه آیا نتیجه مقایسه باید نفی شود یا نه. برای مثال، اگر negated درست باشد، آنگاه مقایسه‌های «برابر» به‌عنوان «مساوی نیست» عمل می‌کنند.
نوع مقایسه
نوع مقایسه برای شرایط تطبیق
Enums
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-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-24 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
