集計メトリクス（旧称：ウェアハウス メトリクス）の概要

集計メトリック（正式にはウェアハウスメトリックと呼ばれます）は、事前に計算されたメトリック値をデータウェアハウスから直接Amplitudeにインポートするため、分析ではウェアハウスにおける信頼できる唯一のソースと同じ数値を使用します。

Amplitudeが行動データから計算するイベントベースのメトリックとは異なり、Aggregated Metrics（旧称: Warehouse Metrics）は、事前に計算された値をウェアハウスから同期します。収益、カスタマー生涯価値、ヘルススコア、財務KPIなどのビジネス指標を、Amplitudeのアナリティクスツールや実験ツールで行動データとともに使用できます。

集計メトリックは、集計したり、実験目標として設定したり、経時的にチャート化したりできる数値の時系列値が必要な場合に使用します。ウェアハウスから最新のユーザー属性のみが必要な場合は、代わりにプロファイルを使用してください。

集計指標（fka ウェアハウスメトリクス）の仕組み

集計されたメトリクス（旧称：ウェアハウスメトリクス）は、データウェアハウスのテーブルから定期的に同期されます。各行には以下が含まれている必要があります。

• 時間：メトリック値が有効な場合。
• ユーザー識別子：メトリックが適用される user_idまたはdevice_id です。
• インサート識別子: 重複排除のためのオプションの一意の識別子です。
• メトリック値：数値（例：収益：13423、カウント：50）。
• ディメンション（オプション）：カテゴリカル属性（例：health_score: "green"、またはpaid: true）。

要件

• Amplitudeプロジェクトです。
• Snowflakeインスタンスへの読み取りアクセス権。
• タイムスタンプとユーザー識別子付きのメトリック値を含むテーブルまたはビュー。
• メトリックテーブルに対して変更データキャプチャ（CDC）が有効になっていること。

メトリックタイプ

集計メトリクス（fka ウェアハウスメトリクス）は、値に対して次の集計タイプをサポートしています。

• 合計: すべての値の合計です。
• 平均値：ユーザーごとの合計額全体の平均値です。
• Min：最小値です。
• Max：最大値です。

詳細については、「倉庫メトリックの計算」を参照してください。

データ型

• メトリクス：数値のみ（整数、小数点）。
• ディメンション：グループ化やフィルタリングに使用する文字列、数値、または論理値です。

一般的なユースケース

集計メトリクス（fkaウェアハウスメトリクス）は、Amplitudeでビジネスメトリクスをネイティブに計算することが困難または不可能である場合の課題を解決します。

収益と財務指標

• 平均注文金額（AOV）：事前に計算されています。
• 残り/使用済みクレジット: アカウント残高の追跡。

これらのメトリクスでは、Amplitudeに効率的に送信するには、大量のデータが必要だったり、機密性が高かったり、イベントベースではない場合がよくあります。

カスタマーの健康状態に関する指標

• カスタマー生涯価値（LTV）：将来を見据えた収益予測。
• ヘルススコア: 複数のデータソースからの複合指標です。
• チャーンリスク: ウェアハウスからの機械学習による予測。

これらのメトリックには、データウェアハウス内で行われるモデリングと予測が必要です。

状態のメトリック

• アクティベーションステータス：ユーザーのオンボーディング状態。
• サブスクリプションティア：現在のプランレベル。
• ベータグループメンバーシップ: 機能アクセスフラグ。
• 実験エクスポージャー: 割り当ての追跡。

これらのメトリックは、個別のイベントではなく現在のユーザー状態を追跡します。

メトリックデータをインポート

集計メトリクス(fkaウェアハウスメトリクス)は、Snowflakeをサポートしています。

変更追跡を有効にする

このテーブルから初めてインポートする場合は、Snowflake で変更追跡を有効にしてください。

ALTER TABLE YOUR_DATABASE.YOUR_SCHEMA.YOUR_METRICS_TABLE
  SET DATA_RETENTION_TIME_IN_DAYS = 7;
ALTER TABLE YOUR_DATABASE.YOUR_SCHEMA.YOUR_METRICS_TABLE
  SET CHANGE_TRACKING = TRUE;

接続と設定

Snowflake Data Import の手順に従って、Snowflake インスタンスに接続してください。

データ仕様

メトリックテーブルには特定の必須フィールドが含まれている必要があります。オプションで追加フィールドを含めることもできます。 少なくとも1つのメトリックまたはディメンションフィールドを含める必要があります。

必須フィールド

オプションフィールド

メトリックフィールド

メトリックテーブルには、少なくとも1つのメトリックまたはディメンションフィールドが含まれている必要があります。

例

{
  "time": "1762813185",
  "user_id": "user_12345",
  "total_revenue": 1543.5,
  "order_count": 12,
  "ltv": 15430.0,
  "health_score": "green",
  "is_paid": true
}

クエリテンプレート

SELECT
  event_date AS "time",
  user_id AS "user_id",
  total_revenue AS "total_revenue",
  order_count AS "order_count",
  ltv AS "ltv",
  health_score AS "health_score",
  is_paid_customer AS "is_paid"
FROM DATABASE_NAME.SCHEMA_NAME.METRICS_TABLE
WHERE event_date >= CURRENT_DATE - INTERVAL '30 days'

実験にメトリックを追加する

エンドツーエンドの実験や実験結果において、集計メトリクス（旧称ウェアハウスメトリクス）を次のように使用します。

• 目標: ビジネス指標への影響を測定します。
• 分析指標: 実験が収益、LTV、その他のKPIにどのように影響するかを理解します。

実験を作成または編集するときは、メトリクスピッカーでウェアハウスソースからメトリクスを選択します。

実験でウェアハウスメトリックを作成する

1. この実験では、メトリクスパネルに移動します。
2. 「カスタムメトリックを作成」をクリックします。
3. メトリックの名前と説明を入力してください。
4. 倉庫タブをクリックします。
5. データのインポート時に指定したテーブルを選択します。
6. メトリックを定義します。 合計、ユーザー平均、最小値、または 最大値 を選択します。
7. 選択した定義を使用して、テーブル内で結合する列を選択します。
8. 結果をプレビューし、保存をクリックします。

ベストプラクティス

1. メトリクスを一度定義する：ウェアハウスでメトリクスを作成し、Amplitudeのあらゆる場所でそれらを参照できます。
2. わかりやすい名前を使用する: 指標に明確な名前を付ける(例えば、「metric_1」ではなく「平均注文額」など)。
3. 説明を含める：メトリック作成フローに説明を追加することで、ユーザーが各メトリックが何を測定するかを理解できるようになります。
4. 主要な指標から始める: 拡張する前に、5〜10個の重要な指標から始めてください。

トラブルシューティング

集計メトリクス（旧称：ウェアハウスメトリクス）に関する問題が発生した場合、これらの一般的な問題と解決策が解決に役立ちます。

同期エラー

• Snowflake Standard Editionを使用している場合は1日に設定し、それ以外の場合はデータのリテンション期間が少なくとも7日間であることを確認してください。
• ウェアハウスの資格情報が有効期限切れになっていないことを確認します。
• テーブル構造が変更されていないことを確認してください。
• Snowflakeのテーブルまたはビューで変更データキャプチャ（CDC）が有効になっていることを確認してください。
• アクティビティログで同期が正常に完了したことを確認してください。

制限事項

• 集計メトリクス（fkaウェアハウスメトリクス）には、行ごとに一意のユーザー識別子が必要です。
• メトリック値は数値のみにできます（ディメンションには文字列、数値、またはブール値を指定できます）。
• 各メトリックはポイントインタイム値を表すものであり、イベントストリームではありません。
• Amplitudeは、一意のユーザー識別子のないロールアップテーブルや複合テーブルをサポートしていません。
• 集計メトリクス（旧称：ウェアハウスメトリクス）は、CUPED やグループ化基準をサポートしていません。

よくある質問

イベントをAmplitudeに送信せずに集計メトリクス（fkaウェアハウスメトリクス）を使用する

はい。ただし、集計されたメトリクス（fka ウェアハウスメトリクス）は、行動イベントと組み合わせた場合に最も強力です。 必要に応じて、メトリックのみのグラフを作成できます。

集計メトリクス（fka ウェアハウスメトリクス）とプロファイルの違い

プロファイルは現在のユーザー属性を同期します。 集計メトリクス（旧称ウェアハウスメトリクス）は時系列の数値を同期させます。これらの値を組み合わせたり、実験目標として使用したり、時間をかけて視覚化したりできます。