数値ディメンション

重要

Data Workbench 提供終了のお知らせ.

数値ディメンションは、順序付け可能な数値エレメントで構成され、その親の可算ディメンションとの間に 1 対多の関係を持ちます。

数値ディメンションは、親ディメンションのエレメントが持つ数値プロパティを表したもの、と考えることができます。例えば、Web データを扱っている場合、Session ディメンションを切り口として各セッションの売上金額（ドル単位）を定義する Session Revenue（セッション売上）という数値ディメンションを定義することができます。セッションごとの売上は 1 つだけですが、売上金額が同じであるセッションは複数存在する可能性もあります。したがって、Session Revenue ディメンションと Session ディメンションには 1 対多の関係が存在することになります。

数値ディメンションは多くの場合、値を合計したり、特定の条件の出現回数をカウントしたり、最小／最大値を特定したりするための指標を定義するときに使用します。例えば、Revenue（売上）という指標は、Session Revenue（セッション売上）ディメンションを使用して sum(Session_Revenue, Session) と定義することができます。このように、Revenue 指標を定義することによって、選択されたセッションの総売上高を得ることができます。

数値ディメンションを他のディメンションの親にすることはできません。

数値ディメンションは、以下のパラメーターによって定義します。

パラメーター 説明 デフォルト
名前 Data Workbench に表示される、ディメンションのわかりやすい名前。ディメンション名にハイフン（-）を含めることはできません。
Clip Values true または false。Min 値と Max 値の範囲に収まるように（演算後の）入力値をクリッピングするかどうかを指定します。Clip Values が true の場合、指定された範囲に値がクリッピングされます。Clip Values が false の場合、親ディメンションのエレメントの値は返されません。
コメント （オプション）。拡張ディメンションについてのメモ。
条件 入力フィールドが数値ディメンションの作成に寄与する条件。
Fixed Size true または false。ディメンション内のエレメント数（ユニーク数）を制御します。true の場合、Min と Max の範囲のすべてのエレメントがディメンションに含められます。false の場合、値が追加されるにつれてディメンションのサイズが大きくなります。 false
Hidden Data Workbench のインターフェイスにディメンションを表示するかどうかを指定します。デフォルトでは false に設定されています。例えば、指標の基準としてのみ使用されるディメンションであれば、このパラメーターを true に設定して、Data Workbench に表示されないようにすることができます。 false
Input

指定した演算に使用する値または出現回数のカウント対象となる入力値。

このフィールドが文字列ベクトルである場合、ベクトルに含まれるエレメントごとに評価が実行されます。例えば、ベクトルの長さが 3 で、Operation が COUNT である場合、カウントに 3 が加算されます。

Min 最終的に得られるディメンションの下限。 0
Max 最終的に得られるディメンションの上限。 1e6
Offset この表の「Scale」を参照してください。 0
操作

利用可能な演算は次のとおりです。

  • COUNT：全ログエントリ中、ディメンションの Condition を満たす Input フィールドの、ブランクではない値の総数が使用されます。Input フィールドがベクトルフィールドである場合、各ログエントリの、ブランクではない値の総数がカウントされます。
  • FIRST NONBLANK：ブランクではない最初の入力値が使用されます。最初のログエントリからの入力値であるとは限りません。Input がベクトルフィールドである場合、関連するログエントリのベクトルの先頭行が使用されます。その値が数値ではない場合、いずれの値も使用されません。
  • FIRST ROW：入力がブランクであった場合も含め、親ディメンションエレメントに関連した最初のログエントリの値が使用されます。Input がベクトルフィールドである場合、関連するログエントリのベクトルの先頭行が使用されます。その値がブランクであるか、数値以外であった場合、あるいは、関連するログエントリがディメンションの Condition を満たしていない場合は、いずれの値も使用されません。
  • LAST NONBLANK：ブランクではない最後の入力値が使用されます。最後のログエントリからの入力値であるとは限りません。Input がベクトルフィールドである場合、関連するログエントリのベクトルの先頭行が使用されます。その値が数値ではない場合、いずれの値も使用されません。
  • LAST ROW：入力がブランクであった場合も含め、親ディメンションエレメントに関連した最後のログエントリの値が使用されます。Input がベクトルフィールドである場合、関連するログエントリのベクトルの先頭行が使用されます。その値がブランクであるか、数値以外であった場合、あるいは、関連するログエントリがディメンションの Condition を満たしていない場合は、いずれの値も使用されません。
  • SUM：全ログエントリ中、ディメンションの Condition を満たす Input フィールドのすべての数値の合計が使用されます。該当するログエントリが存在しない場合や、数値が見つからない場合、0（数値）が使用されます。
  • MIN または MAX：全ログエントリ中、ディメンションの Condition を満たす Input フィールドの最小または最大の数値。該当するログエントリが存在しない場合や、数値が見つからない場合、いずれの値も使用されません。

注意：意図したディメンションが確実に定義されるように演算を指定する必要があります。

Parent 親ディメンションの名前。すべての可算ディメンションは、親ディメンションになることができます。
Scale

ディメンションの序数値を得るために、Operation の結果が次のように変換されます。

(Scale * Input) + Offset

1.0
メモ

If Operation は、値を生み出さない、または Clip Values が false で、値が次の値の間でない Min および Maxの場合、数値ディメンションの要素は親ディメンションの要素に関連付けられていません。

次の例は、Web サイトトラフィックから収集されたイベントデータを使用する数値ディメンションの定義です。この数値ディメンション（Ad View Counter）は、特定のセッション期間中に訪問者が広告を閲覧した回数をカウントします。Web サーバーからの広告リソース要求がすべて、「ad=」を含んだ cs-uri-query で行われることを前提としています。この例で関心の対象となっているのは、フィールドの実際の値ではなく、訪問者に広告が表示された回数（COUNT）です。

このページ