Dimension

ディメンションはデータの属性です。たとえば、「市区町村」のディメンションは、イベントが発生した市区町村を表します。レポート レスポンスのディメンション値は文字列です。たとえば、市区町村は「横浜」や「川崎」などになります。リクエストでは最大 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 表現 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "lowerCase": {
    object (CaseExpression)
  },
  "upperCase": {
    object (CaseExpression)
  },
  "concatenate": {
    object (ConcatenateExpression)
  }
  // End of mutually exclusive fields.
}
フィールド
DimensionExpression にディメンション式のタイプを 1 つ指定します。以下は、相互に排他的なフィールドのリストです。レスポンスで設定されるフィールドは最大で 1 つです。
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」が含まれます。