你衡量API活跃用户的方法是错误的

了解你的API用户始于正确的KPI。但是，一个活跃的用户是什么样子的，你如何衡量他们？请阅读我们的文章以了解更多。

API提供商需要了解他们的消费者是如何使用他们的API的。使用指标至关重要，因为它们告诉你API的采用情况，你的API是如何随时间增长的，以及哪些端点的使用率更高（或更低）。当你看API使用指标时，你应该在与你的服务最密切相关的意义上测量你的API上的活跃用户。这将告知你的组织在哪里分配计算资源，你决定开发哪些API端点，以及你记录哪些API端点。

什么是活跃用户？乍一看，它可能只是简单地跟踪使用一个端点的用户数量。但API用户不能像网站用户那样被追踪。相反，你需要看看你的用户如何在你的产品背景下访问你的API。

一个API上的活跃用户是什么样子的？一个活跃的API用户是指任何定期调用你的API以实现实际结果的用户。这并不意味着他们必须不断地进行API调用才能被认为是活跃的。一个API消费者进行API调用的频率取决于你的API的上下文。如果一个活跃的用户需要从你的API中获得价值，那么他可能每天都会进行许多API调用；如果他们需要从你的API中获得的只是每周的数据处理，那么他们可能每周只需要进行一次API调用。一个常见的做法是将你的API使用指标分为每日活跃用户和每月活跃用户，以更清楚地了解你的用户在不同的兴趣时间段内的活跃程度。

虽然采取一刀切的方法来衡量活跃的API用户是很诱人的，但当你决定衡量什么时，你需要看看你的API的背景。你的衡量标准应该反映你的API在现实世界中如何为用户创造价值。例如，一个允许你发送短信的API应该跟踪用户发送的短信数量。一个压缩视频的API应该跟踪压缩后发送给每个用户的数据文件的大小。这些指标应该与所提供的服务的价值直接相关。

坏指标，好指标

虽然API供应商通过跟踪独立用户的数量来衡量活跃用户是很常见的，但这是一个虚荣的指标，使事情看起来很好，但并没有真正传达出多少信息。由于独立用户的数量通常会随着时间的推移而增加，所以我们很想指出这样的指标，因为它可以向内部利益相关者讲述一个积极的故事。不幸的是，简单地计算独立用户的活跃度是一个糟糕的指标，因为它没有给你关于你的用户在使用你的API做什么的细节。如果你是一家百货公司，这与计算窗口购物者的数量没有太大区别。有趣的是，它并没有告诉你有多少人进来买东西，他们买了什么，或者他们花了多少钱。相应地，你想知道用户是否以有意义的方式继续使用你的API，为你的API消费者创造了多少价值，以及哪些API端点和功能对你的用户最有价值。如果没有关于你的API消费者的有意义的信息，你的组织就不能决定在哪里应用新的开发或如何分配资源。

随着你的用户群的增长，扩展你的API指标是很重要的，但它经常被忽视。当你有少量的API消费者和少量的使用模式时，衡量活跃用户可能是直接的。但是，随着你的API越来越复杂，准确测量有意义的用户活动就变得更加具有挑战性。你需要一个前瞻性的指标战略，随着你的API的增长而发展。这有一个额外的好处，就是确保你的组织不会因为你的API增长而遗弃老用户。像你的组织所创建的API密钥的独特数量，或对你的API端点的调用总数这样的指标，并不总是表明它们最初所衡量的东西。例如，一个开发人员可能创建多个API密钥。

让我们来看看好的指标是什么样子的。好的指标应该给你关于你的API消费者如何与你的API互动的有意义的信息。你的指标应该能够回答以下问题:

你的API响应中提供了多少数据？这些数据都是有用的吗？
每个用户与你的API保持连接的时间是多久？
哪些端点的活动最多？
用户在进行API调用时的成功率如何？

好的指标告诉你的不仅仅是有多少开发者使用了你的API。上面的问题是考察你的API消费者对你的API的参与程度的不同方式。如果你的API专注于在不同的设备之间传输数据，那么传输的数据量是衡量你的用户参与程度的一个重要指标。另一方面，如果你的API提供实时服务，比如视频内容的实时字幕，那么连接的长度将是一个更好的参与指标。

API活跃用户，真实的

一个好的指标的起点是将你的API调用汇总成有意义的事件，而不是看API调用的原始数量，这可能是一个嘈杂的信号。一个事件可以是对一个API调用的更详细的观察，结合一个API调用和它的结果。

衡量事件而不是API调用还可以让你看看不同类型的事件如何比较，包括它们有什么共同点。观察失败的事件可以揭示失败的共同来源。例如，如果你的用户遇到失败的事件是因为有太多的流量进入你的API端点，你的组织可以通过为你的API分配更多的资源来处理这个问题。另外，与你的开发者入职相关的失败事件模式可能表明你的用户在开始使用你的API时遇到困难。这可能表明需要更全面的文档，或者你的用户可能需要额外的支持来整合你的API。

让我们看看API事件指标的一些现实世界的例子。一个执行双因素验证的API会有至少四个基本的API事件。成功发送验证短信将是第一个API事件，与发送短信失败的事件相搭配。另外两个事件是当验证码被成功验证和验证码被失败时。这些事件加在一起，显示了API消费者成功使用API来实现其目标（在这个例子中，验证一个电话号码）的频率。通过将它们归类为事件来区分成功和失败的API交互，可以很容易地了解你的API所发生的真实活动。

最佳实践

虽然我们已经讨论了如何用事件来衡量活跃的API用户可以更好地了解你的API消费者是如何使用你的API的，但还有其他好处。例如，你可以使用你的活跃API使用指标，直接根据你的服务为用户创造的价值向用户收费。你的组织可以为成功的事件计费，从而将计费直接与现实世界的结果联系起来。例如，一个拨打电话的API可以根据通话时间计费，一个发送短信的API可以根据发送的短信数量计费。

在依赖活跃用户指标时，实时报告是至关重要的。在用户使用你的API时，通过测量你的用户可以获得许多有价值的洞察力。例如，你可以在你的用户遇到失败的事件时立即发现它们，使你的团队有可能实时解决故障。如果用户的问题得到及时的支持，他们就不太可能离开你的服务。实时分析还允许你的组织查看在某一时刻成功事件的数量与失败事件的数量的比较，例如在重负荷时期。有了实时事件指标，你的团队可以迅速响应用户的需求，监控失败的事件，并看到哪些端点为用户提供了最大的价值。

实时的成功

衡量API用户的总数可能会产生误导，因为它没有给你提供关于你的API消费者如何从你的API获得价值的背景信息。将你的API调用批量化为事件，将为你的组织提供规模化的API信息指标。你将能够评估失败的事件，以便你的组织能够了解你的哪个API端点需要更多关注和资源。你还可以比较成功事件的模式，这样你的组织就可以了解哪些端点为你的API消费者创造了最大的价值。

为了了解你的用户，将你的指标集中在他们使用你的API的目的，以及他们是否真正实现了他们的预期结果。你的衡量标准应该集中在为你的用户创造最大价值的API事件上，这样你就会明白应该把你的资源集中在哪里。通过实时测量他们的活动来了解你的用户，给你自己最好的机会来解决他们的需求。如果你一直以来对API活跃用户的测量都是错误的，现在是时候重新思考你的策略了。你的内部利益相关者和你的客户都会为此感谢你。