各値がルックバック期間中に、少なくとも最小限の期間出現した場合に、その値の個別のカウントを計算します。
「ファン以外」の出現を含まずに、個別の「ファン」のカウントを計算する場合に便利です。 ユーザーは、ルックバック期間中にアクティブだった場合に「ファン」としてカウントされます。 ルックバック期間は、ユーザーが active (「ファン」) かどうかを判断するためにのみ使用されます。 集計自体には、ルックバック ウィンドウのユーザーは含まれません。 これに対して、 sliding_window_counts 集計は、ルックバック期間のスライディング ウィンドウで実行されます。
構文
T | evaluate active_users_count(IdColumn, TimelineColumn, Start, End, LookbackWindow, Period, ActivePeriodsCount, Bin , [dim1, dim2, ...])
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
| T | string |
✔️ | アクティブなユーザーのカウントに使用される表形式の入力。 |
| IdColumn | string |
✔️ | ユーザー アクティビティを表す ID 値を持つ列の名前。 |
| TimelineColumn | string |
✔️ | タイムラインを表す列の名前。 |
| Start | datetime |
✔️ | 分析の開始期間。 |
| End | datetime |
✔️ | 分析の終了期間。 |
| LookbackWindow | timespan |
✔️ | ユーザーの外観がチェックされる期間を定義する時間枠。 ルックバック期間は ([現在の外観] - [ルックバック ウィンドウ]) で始まり、([現在の外観]) で終了します。 |
| 期間 | timespan |
✔️ | 1 つの外観としてカウントする定数 (この期間の少なくとも個別の ActivePeriodsCount に表示される場合、ユーザーはアクティブとしてカウントされます)。 |
| ActivePeriodsCount | decimal |
✔️ | ユーザーがアクティブかどうかを決定する個別のアクティブな期間の最小数。 アクティブ ユーザーとは、アクティブな期間に少なくとも (または同等以上) に出現したユーザーのことを指します。 |
| Bin | decimal、datetime、または timespan | ✔️ | 分析ステップ期間の定数値。 week、month、またはyearの文字列を指定することもできます。 すべての期間は、対応する startofweek、 startofmonth、またはstartofyear 関数になります。 |
| dim1, dim2, ... | dynamic |
アクティビティ メトリックの計算をスライスするディメンション列の配列。 |
返品
ルックバック期間、各タイムラインの期間、および既存の各ディメンションを組み合わせた期間中に、ActivePeriodCounts に出現した Id の個別のカウント値を持つテーブルを返します。
出力テーブル スキーマは次のとおりです。
| TimelineColumn | dim1 | .. | dim_n | dcount_values |
|---|---|---|---|---|
| 型: TimelineColumn 現在 | .. | .. | .. | long |
例
過去8日間に少なくとも3つの異なる日に出現した個別のユーザー数を週次で計算します。 解析期間: 2018 年7月
let Start = datetime(2018-07-01);
let End = datetime(2018-07-31);
let LookbackWindow = 8d;
let Period = 1d;
let ActivePeriods = 3;
let Bin = 7d;
let T = datatable(User:string, Timestamp:datetime)
[
"B", datetime(2018-06-29),
"B", datetime(2018-06-30),
"A", datetime(2018-07-02),
"B", datetime(2018-07-04),
"B", datetime(2018-07-08),
"A", datetime(2018-07-10),
"A", datetime(2018-07-14),
"A", datetime(2018-07-17),
"A", datetime(2018-07-20),
"B", datetime(2018-07-24)
];
T | evaluate active_users_count(User, Timestamp, Start, End, LookbackWindow, Period, ActivePeriods, Bin)
出力
| タイムスタンプ | dcount |
|---|---|
| 2018-07-01 00:00:00.0000000 | 1 |
| 2018-07-15 00:00:00.0000000 | 1 |
次の両方の条件を満たしている場合、ユーザーはアクティブと見なされます。
- ユーザーが、少なくとも3つの異なる日 (Period = 1d、ActivePeriods = 3) に出現していた。
- ユーザーは、現在の出現を含めて、8 日間のルックバック ウィンドウで出現している。
次の図では、この条件によってアクティブになっているのは、7/20 のユーザー A と7/4 のユーザー B のみです (上記のプラグインの結果を参照してください)。 ユーザー B の出現は7/4 のルックバック ウィンドウに含まれていますが、6/29 - 30 の開始から終了までの時間範囲には含まれていません。
