Dimension

ディメンションはデータの属性です。たとえば、ディメンション「city」はイベントが発生した都市を示します。レポートのレスポンスのディメンション値は文字列です。たとえば、都市は「パリ」や「ニューヨーク」です。リクエストできるディメンションは最大 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 つのディメンションは、複数のディメンションの式の結果になることがあります。たとえば、ディメンション「country, city」の場合は 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 つのディメンションにまとめるために使用します。たとえば、ディメンション「country, city」の場合は concatenate(country, ", ", city)。

CaseExpression

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

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」が含まれます。