Dimension

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

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

string

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

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

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

dimensionExpression

object (DimensionExpression)

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

DimensionExpression

משמשת לציון מאפיין שהוא תוצאה של מספר מאפיינים. שימושים לדוגמה: 1) lowerCase(dimension) 2) concatenate(dimension1, km, 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)

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

CaseExpression

משמשת להמרה של ערך מאפיין לאירוע בודד.

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

string

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

ConcatenateExpression

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

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

string

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

delimiter

string

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

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