Dimension

המאפיינים הם מאפייני הנתונים. לדוגמה, המאפיין 'עיר' מציין את העיר שממנה הגיע האירוע. ערכי המאפיינים בתשובות לדוחות הם מחרוזות. לדוגמה, העיר יכולה להיות 'פריז' או 'ניו יורק'. בקשות יכולות לכלול עד 9 מאפיינים.

ייצוג ב-JSON 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
שדות
name

string

שם המאפיין. במאפייני ה-API מופיעה רשימה של שמות המאפיינים שנתמכים בשיטות דיווח ליבה, כמו runReport ו-batchRunReports. ברשימת מאפיינים בזמן אמת מפורטת רשימת שמות המאפיינים שנתמכים בשיטה runRealtimeReport. רשימת שמות המאפיינים שנתמכים בשיטה runFunnelReport מפורטת במאמר מאפייני משפך.

אם מציינים את dimensionExpression, הערך של name יכול להיות כל מחרוזת שרוצים מתוך קבוצת התווים המותרת. לדוגמה, אם dimensionExpression מורכב מ-country ו-city, אפשר לקרוא למאפיין הזה countryAndCity. שמות המאפיינים שבוחרים חייבים להתאים לביטוי הרגולרי ^[a-zA-Z0-9_]$.

המאפיינים מופיעים כ-name ב-dimensionFilter, ב-orderBys, ב-dimensionExpression וב-pivots.
dimensionExpression

object (DimensionExpression)

מאפיין אחד יכול להיות תוצאה של ביטוי של כמה מאפיינים. לדוגמה, המאפיין 'מדינה, עיר': concatenate(country, ", ", city).

DimensionExpression

משמש לביטוי מאפיין שהוא תוצאה של נוסחה של כמה מאפיינים. דוגמאות לשימוש: 1) lowerCase(dimension)‏ 2) concatenate(dimension1, symbol, dimension2).

ייצוג ב-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 יכול להיות רק אחת מהאפשרויות הבאות:
lowerCase

object (CaseExpression)

הפונקציה משמשת להמרת ערך של מאפיין לאותיות קטנות.
upperCase

object (CaseExpression)

הפונקציה משמשת להמרת ערך של מאפיין לאותיות גדולות.
concatenate

object (ConcatenateExpression)

משמש לשילוב ערכי מאפיינים למאפיין יחיד. לדוגמה, המאפיין 'מדינה, עיר': concatenate(country, ", ", city).

CaseExpression

הפונקציה משמשת להמרת ערך של מאפיין למקרה יחיד.

ייצוג ב-JSON 
{
  "dimensionName": string
}
שדות
dimensionName

string

השם של מאפיין. השם חייב להפנות לשם בשדה המאפיינים של הבקשה.

ConcatenateExpression

משמש לשילוב ערכי מאפיינים למאפיין יחיד.

ייצוג ב-JSON 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
שדות
dimensionNames[]

string

שמות של מאפיינים. השמות חייבים להפנות לשמות בשדה המאפיינים של הבקשה.
delimiter

string

התו המפריד שמופיע בין שמות המאפיינים.

תווים מפרידים הם בדרך כלל תווים בודדים כמו '|' או ',', אבל הם יכולים להיות גם מחרוזות ארוכות יותר. אם ערך המאפיין מכיל את התו המפריד, שניהם יופיעו בתגובה ללא הבחנה. לדוגמה,אם הערך של מאפיין 1 = "US,FR", הערך של מאפיין 2 = "JP" והמפריד = ",", התגובה תכיל את הערך "US,FR,JP".