本文へ移動
製品分析 SQL レシピ

アクティベーションまでの時間を測定する

サインアップからユーザーの最初の意味のある製品アクションまでの経過時間の分布を計算します。

上級者向けproduct_eventsレビュー済み 2026-07-27テスト済み アパッチ DataFusion 45.2.0

レビュー者 Telemetry 製品チーム に . SQL構文、必要なイベント項目、サンプル結果、クエリの利用上の制限を確認しました. このページのレビュー担当

質問に回答しました

新しいユーザーが最初の意味のあるアクションに到達するまでにどれくらい時間がかかりますか?

転換率は、アクティベーションに至ったユーザーの割合を示します。アクティベーションまでの時間を確認すると、実際の行動に合ったオンボーディングの観察期間を選べます。

イベントスキーマ

クエリが期待するフィールド

フィールド種類なぜ存在するのか
timestamp_utcTimestampイベント時間。
user_idUtf8安定したユーザー識別子。
event_nameUtf8サインアップまたはアクティベーションのマイルストーン。
DataFusion SQL

クエリをコピーする

sql
WITH milestones AS (
  SELECT
    user_id,
    MIN(CASE
      WHEN event_name = 'signup_completed' THEN timestamp_utc
    END) AS signed_up_at,
    MIN(CASE
      WHEN event_name = 'first_meaningful_action_completed' THEN timestamp_utc
    END) AS activated_at
  FROM product_events
  WHERE timestamp_utc >= now() - INTERVAL '90 days'
  GROUP BY user_id
)
SELECT
  CASE
    WHEN activated_at - signed_up_at < INTERVAL '10 minutes' THEN 'under 10m'
    WHEN activated_at - signed_up_at < INTERVAL '1 hour' THEN '10m–1h'
    WHEN activated_at - signed_up_at < INTERVAL '1 day' THEN '1h–1d'
    WHEN activated_at - signed_up_at < INTERVAL '7 days' THEN '1d–7d'
    ELSE '7d+'
  END AS activation_window,
  COUNT(*) AS users
FROM milestones
WHERE signed_up_at IS NOT NULL
  AND activated_at >= signed_up_at
GROUP BY activation_window
ORDER BY users DESC;

この読み取り専用クエリは、空の型付きテーブルに対して計画され、実行されます。 アパッチ DataFusion 45.2.0。決定論的なサンプル出力は合成され、個別にレビューされます。フィールド タイプ、しきい値、ビジネス定義を独自のデータと照合して検証します。 テスト方法を読んでください。

クエリ結果

価値実現までの時間枠ごとにアクティブ化されたユーザー

このサンプルのユーザーの多くは、1 日以内にアクティベーションの条件を満たします。数日かかるユーザーもいます。

activation_windowusers
under 10m182
10m–1h264
1h–1d318
1d–7d146
7d+38

合成出力例。運用上の決定に使用する前に、独自のイベント スキーマとしきい値に対してクエリを実行します。

Activated users by time-to-value window: Measure time to activation 結果例からの合成 users 値の静的チャート
決定論的な出力例のインデックス可能な SVG。記事、ランブック、または出典を明示した設計レビューのためにダウンロードしてください。

例を再現する

サンプルデータをダウンロードする

JSON バンドルには、型付きイベント コントラクトが含まれています。 illustrative 入力行、正確な SQL、予想される出力、レビューメモ、およびエンジンのバージョン。 CSV には、表示された結果が含まれます。

SQL の仕組み

  1. 1条件 CASE 式に対する MIN は、各ユーザーの最初のサインアップとアクティベーションのタイムスタンプを検索します。
  2. 2CASE 式は、経過時間を操作上読み取り可能なバケットに変換します。
  3. 3アクティブ化しないユーザーはこの配布から除外され、ファネル コンバージョン ビューに属します。

確認するエッジケース

  • インポートされたユーザーまたは招待されたユーザーには、異なる開始イベントが設定される場合があります。
  • サインアップ前のアクティベーションは通常、ID のマージまたは履歴のバックフィルを示します。
  • 製品の自然な使用サイクルを反映したバケットを選択してください。

推奨されるダッシュボード

  • 分布: アクティベーションウィンドウごとのユーザー
  • 統計: アクティブ化までの時間の中央値
  • 表: 年齢別の非アクティブ化サインアップ

アラートガイダンス

製品レビューのためにディストリビューションを使用します。計測が停止した場合、またはアクティベーションボリュームが崩壊した場合にのみアラートを発します。

アラート設定を読む

このクエリに必要なイベントを設定する

関連する機器とガイド

分析を続ける

自分のイベントで実行する

テーブルを作成し、フィールドを調整して、結果を保存します

無料で始めて、構造化されたイベントを送信し、クエリ結果をグラフ、共有ダッシュボード ウィジェット、またはアラート入力として使用します。

API キーを取得する