跳转到内容
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 密钥