ابعاد ویژگی های داده های شما هستند. به عنوان مثال، شهر بعد شهری را نشان می دهد که یک رویداد از آن سرچشمه می گیرد. مقادیر ابعاد در پاسخ های گزارش رشته ای هستند. به عنوان مثال، شهر می تواند "پاریس" یا "نیویورک" باشد. درخواست تا 9 بعد مجاز است.
نام ابعاد. برای لیستی از نام ابعاد پشتیبانی شده توسط روش های گزارش اصلی مانند runReport و batchRunReports ، به ابعاد API مراجعه کنید. برای لیستی از نام ابعاد پشتیبانی شده توسط روش runRealtimeReportRealtime Dimensions را ببینید. برای لیستی از نام ابعاد پشتیبانی شده توسط روش runFunnelReport به ابعاد قیف مراجعه کنید.
اگر dimensionExpression مشخص شده باشد، name می تواند هر رشته ای باشد که می خواهید در مجموعه کاراکترهای مجاز. به عنوان مثال اگر یک dimensionExpressioncountry و city را به هم متصل می کند، می توانید آن بعد را countryAndCity بنامید. نام ابعادی که انتخاب میکنید باید با عبارت منظم ^[a-zA-Z0-9_]$ مطابقت داشته باشد.
ابعاد با name در dimensionFilter , orderBys , dimensionExpression و pivots ارجاع می شوند.
یک بعد می تواند نتیجه بیان چند بعد باشد. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر).
DimensionExpression
برای بیان یک بعد که حاصل فرمول چند بعد است استفاده می شود. کاربردهای مثال: 1) حروف کوچک (بعد) 2) الحاق (بعد 1، نماد، بعد 2).
نمایندگی JSON
{// Union field one_expression can be only one of the following:"lowerCase": {object (CaseExpression)},"upperCase": {object (CaseExpression)},"concatenate": {object (ConcatenateExpression)}// End of list of possible types for union field one_expression.}
فیلدها
فیلد اتحادیه one_expression . یک نوع عبارت بعد را برای DimensionExpression مشخص کنید. one_expression می تواند تنها یکی از موارد زیر باشد:
برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر).
Case Expression
برای تبدیل مقدار ابعاد به یک مورد استفاده می شود.
نمایندگی JSON
{"dimensionName": string}
فیلدها
dimensionName
string
نام یک بعد نام باید به یک نام در قسمت ابعاد درخواست اشاره کند.
ConcatenateExpression
برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود.
نمایندگی JSON
{"dimensionNames": [string],"delimiter": string}
فیلدها
dimensionNames[]
string
نام ابعاد نام ها باید به نام هایی در قسمت ابعاد درخواست مراجعه کنند.
delimiter
string
جداکننده بین نام ابعاد قرار می گیرد.
جداکننده ها اغلب کاراکترهای منفرد هستند مانند "|" یا ""، اما می تواند رشته های طولانی تر باشد. اگر یک مقدار بعد حاوی جداکننده باشد، هر دو در پاسخ بدون تمایز وجود خواهند داشت. به عنوان مثال اگر مقدار بعد 1 = "US,FR"، مقدار بعد 2 = "JP"، و جداکننده = "،"، پاسخ شامل "US,FR,JP" خواهد بود.
تاریخ آخرین بهروزرسانی 2025-01-06 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","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-01-06 بهوقت ساعت هماهنگ جهانی."],[[["Dimensions represent data attributes, like city or country, and are limited to 9 per request."],["You can create custom dimensions using expressions that manipulate existing dimensions (e.g., lowercase, concatenate)."],["Dimension expressions can combine multiple dimensions with delimiters, such as joining country and city with a comma."],["Dimension names in expressions should refer to existing dimension names defined in the request."],["When using delimiters, ensure they don't clash with values within your dimension data to avoid ambiguity."]]],["This document outlines the structure and usage of dimensions in data reporting, focusing on creating custom dimensions. Dimensions are data attributes, like \"city.\" You can define a `dimension` with a `name` and an optional `dimensionExpression`. `DimensionExpression` allows combining or modifying existing dimensions using `lowerCase`, `upperCase`, or `concatenate` functions. `CaseExpression` changes dimension cases. `ConcatenateExpression` merges dimension values with a specified `delimiter`. Each dimension name is a string with allowed characters.\n"]]