Dimension

ディメンションはデータの属性です。たとえばディメンション「都市」は、イベントが発生した都市を示します。レポート レスポンスのディメンション値は文字列です。たとえば、都市は「パリ」“New York”と入力しますリクエストに使用できるディメンションは最大 9 個です。

JSON 表現 
{
  "name": string,
  "dimensionExpression": {
    object (DimensionExpression)
  }
}
フィールド
name

string

ディメンションの名前。runReport や batchRunReports などの主要なレポート方法でサポートされているディメンション名の一覧については、API のディメンションをご覧ください。runRealtimeReport メソッドでサポートされているディメンション名の一覧については、リアルタイム ディメンションをご覧ください。runFunnelReport メソッドでサポートされているディメンション名の一覧については、ファネルのディメンションをご覧ください。

dimensionExpression を指定する場合は、name に使用可能な文字セット内の任意の文字列を指定できます。たとえば、dimensionExpression が country と city を連結する場合、そのディメンションには countryAndCity という名前を付けます。選択するディメンション名は、正規表現 ^[a-zA-Z0-9_]$ と一致する必要があります。

ディメンションは、dimensionFilter、orderBys、dimensionExpression、pivots の name によって参照されます。
dimensionExpression

object (DimensionExpression)

複数のディメンションの式の結果が 1 つのディメンションになることもあります。たとえば、ディメンション「国, 都市」の場合: 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 には 1 種類のディメンション式を指定します。one_expression は次のいずれかになります。
lowerCase

object (CaseExpression)

ディメンションの値を小文字に変換するために使用します。
upperCase

object (CaseExpression)

ディメンションの値を大文字に変換するために使用します。
concatenate

object (ConcatenateExpression)

ディメンション値を 1 つのディメンションにまとめるために使用します。たとえば、ディメンション「国, 都市」の場合: concatenate(country, ", ", city)。

CaseExpression

ディメンション値を単一の大文字 / 小文字に変換するために使用します。

JSON 表現 
{
  "dimensionName": string
}
フィールド
dimensionName

string

ディメンションの名前。この名前は、リクエストのディメンション フィールド内の名前を参照する必要があります。

ConcatenateExpression

ディメンション値を 1 つのディメンションにまとめるために使用します。

JSON 表現 
{
  "dimensionNames": [
    string
  ],
  "delimiter": string
}
フィールド
dimensionNames[]

string

ディメンションの名前。名前は、リクエストのディメンション フィールド内の名前を参照する必要があります。
delimiter

string

ディメンション名の間に配置される区切り文字。

多くの場合、区切り文字は "|" のように 1 文字です。または「,」長い文字列でもかまいませんディメンション値に区切り文字が含まれている場合、両方が区別なくレスポンスに存在します。たとえば、ディメンション 1 の値が「US,FR」、ディメンション 2 の値が「JP」、区切り文字が「,」の場合、レスポンスには「US,FR,JP」が含まれます。