跳至主要內容
Telemetry
產品分析 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。確定性樣本輸出是綜合的並單獨審查;根據您自己的資料驗證欄位型別、閾值和業務定義。 閱讀測試方法。

查詢結果

按價值實現時間視窗啟用使用者

大多數活躍使用者在一天內達到價值,但分佈具有有意義的多日尾部。

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從未啟用的使用者將被排除在此分佈之外,並屬於渠道轉化檢視。

需要決定的邊緣情況

  • 匯入或邀請的使用者可能有不同的起始事件。
  • 註冊前啟用通常表示身分合併或歷史回填。
  • 選擇反映產品自然使用週期的桶。

推薦儀表板

  • 分佈:按啟用視窗劃分的使用者
  • Stat:啟用的中位時間
  • 資料表:按年齡劃分的非啟用註冊人數

警示指導

使用該發行版進行產品審查;僅當埋點停止或啟用量崩潰時發出警示。

讀取警示設定

讓查詢範例發揮作用

相關埋點和指南

繼續分析

在真實事件中執行它

建立資料表,調整欄位並儲存結果

免費開始,傳送結構化事件,並將查詢結果用作圖表、共享儀表板小工具或警示輸入。

獲取 API 金鑰