سرور MCP را برای Google Analytics امتحان کنید. از 
GitHub نصب کنید و برای جزئیات بیشتر به 
اطلاعیه مراجعه کنید.
        
 
     
  
  
  
    
  
  
  
    
      Dimension
    
    
      
    
    
      
      با مجموعهها، منظم بمانید
    
    
      
      ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
    
  
  
      
    
  
  
  
  
  
    
  
  
    
    
     ابعاد ویژگی های داده های شما هستند. به عنوان مثال، شهر بعد شهری را نشان می دهد که یک رویداد از آن سرچشمه می گیرد. مقادیر ابعاد در پاسخ های گزارش رشته ای هستند. به عنوان مثال، شهر می تواند "پاریس" یا "نیویورک" باشد. درخواست تا 9 بعد مجاز است.
| فیلدها | 
|---|
| name |  string  نام ابعاد. برای لیستی از نام ابعاد پشتیبانی شده توسط روش های گزارش اصلی مانند runReportوbatchRunReports، به ابعاد API مراجعه کنید. برای لیستی از نام ابعاد پشتیبانی شده توسط روشrunRealtimeReport، Realtime Dimensions را ببینید. برای لیستی از نام ابعاد پشتیبانی شده توسط روشrunFunnelReportبه ابعاد قیف مراجعه کنید.  اگر dimensionExpressionمشخص شده باشد،nameمی تواند هر رشته ای باشد که می خواهید در مجموعه کاراکترهای مجاز. به عنوان مثال اگر یکdimensionExpressioncountryوcityرا به هم متصل می کند، می توانید آن بعد راcountryAndCityبنامید. نام ابعادی که انتخاب میکنید باید با عبارت منظم^[a-zA-Z0-9_]$مطابقت داشته باشد.  ابعاد با nameدرdimensionFilter,orderBys,dimensionExpressionوpivotsارجاع می شوند. | 
| dimension Expression |  object ( DimensionExpression)  یک بعد می تواند نتیجه بیان چند بعد باشد. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر).  | 
 DimensionExpression
 برای بیان یک بعد که حاصل فرمول چند بعد است استفاده می شود. کاربردهای مثال: 1) حروف کوچک (بعد) 2) الحاق (بعد 1، نماد، بعد 2). 
| نمایندگی JSON | 
|---|
| {
  // Union field one_expressioncan be only one of the following:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of list of possible types for union fieldone_expression.
} | 
| فیلدها | 
|---|
| فیلد اتحادیه one_expression. یک نوع عبارت بعد را برایDimensionExpressionمشخص کنید.one_expressionمی تواند تنها یکی از موارد زیر باشد: | 
| lower Case |  object ( CaseExpression)  برای تبدیل مقدار ابعاد به حروف کوچک استفاده می شود. | 
| upper Case |  object ( CaseExpression)  برای تبدیل مقدار ابعاد به حروف بزرگ استفاده می شود. | 
| concatenate |  object ( ConcatenateExpression)  برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود. به عنوان مثال، بعد "کشور، شهر": concatenate(کشور، "، "، شهر).  | 
Case Expression
 برای تبدیل مقدار ابعاد به یک مورد استفاده می شود. 
| نمایندگی JSON | 
|---|
| {
  "dimensionName": string
} | 
| فیلدها | 
|---|
| dimension Name |  string  نام یک بعد نام باید به یک نام در قسمت ابعاد درخواست اشاره کند.  | 
 ConcatenateExpression
 برای ترکیب مقادیر ابعاد به یک بعد واحد استفاده می شود. 
| نمایندگی JSON | 
|---|
| {
  "dimensionNames": [
    string
  ],
  "delimiter": string
} | 
| فیلدها | 
|---|
| dimension Names[] |  string  نام ابعاد نام ها باید به نام هایی در قسمت ابعاد درخواست مراجعه کنند. | 
| delimiter |  string  جداکننده بین نام ابعاد قرار می گیرد.  جداکننده ها اغلب کاراکترهای منفرد هستند مانند "|" یا ""، اما می تواند رشته های طولانی تر باشد. اگر یک مقدار بعد حاوی جداکننده باشد، هر دو بدون هیچ تمایزی در پاسخ وجود خواهند داشت. به عنوان مثال، اگر مقدار بعد 1 = "US,FR"، مقدار بعد 2 = "JP" و جداکننده = "،"، پاسخ شامل "US,FR,JP" خواهد بود. | 
  
  
  
    
  
 
  
    
    
      
       
    
    
  
  
  جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
  تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
  
  
  
    
      [null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[],["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"]]