开发人员全程指南：深入 API 分析与优化

每个 API 产品经理都希望尽可能多的开发人员采纳并使用其 API。目标是提供快速访问 Hello World 的能力，并确保优质的开发人员体验 (DX)。最终的目标是将 API 的成功与公司的总体战略目标对接。然而，很多情况下，尽管意图良好，现有的指标往往过于简单、狭窄，并依赖于过时的参与模型。

通过全面的 API 分析，可以在从注册和培训到 Hello World 实例及应用程序部署的整个过程中指导 API 用户。仅让用户开始使用 API 通常是不够的，更重要的是确保他们能够充分利用它。API 的初步使用不能全面反映客户体验。通过分析，可以精心规划每个 API 的设计，提升开发人员体验，并最大化产品的效果。

推动开发人员从 API 注册到成功集成

开发人员在选择要集成的 API 时通常会有多种选择，也可能决定是否进行集成。当成功吸引开发人员注册 API 后，接下来的关键是推动他们迈出下一步。需在微观层面关注个体成功，同时争取整体 API 旅程中的宏观成功。

作为 API 提供商，应确保每位创建账户的开发人员能够成功将 API 集成到其应用中。API 分析可以帮助实现以下目标：

• 改进 API 的引导过程
• 帮助开发人员更快实现 Hello World
• 鼓励使用更多的 API 功能和端点

这些目标可能已经相对熟悉，可能在数据支持不足的情况下进行过尝试。深度集成的成功往往不易跟踪，这通常因为其效果不容易直接观察到。

改进 API 引导流程

从用户生成 API 密钥到将 API 集成到应用程序中，这一过程可能涉及多个步骤。通过 API 分析和用户界面数据，可以在开发人员入门过程中进行跟踪，从不同的环节收集数据，例如：

• 用户注册 API 账户时
• 用户生成 API 密钥时
• 入门流程中包含的每个步骤或页面
• 用户进行首次 API 调用时

应深入分析 API 和用户数据，以确定最适合大多数开发人员的入门流程。入门期间用户必须做出的决策应尽量减少。建议先提供有限的入门选项，然后根据收集的数据逐步扩展入门路径。

通过分析 API 和用户数据，并及时发送定制化的电子邮件，可以实现个性化的入门体验。

初步入门可以吸引那些正在尝试的开发人员。API 分析的下一步应是获得见解，帮助这些开发人员更快地实现 Hello World。

帮助开发人员更快地进入 Hello World

查看 API 数据可能会发现，一些开发人员在从预集成阶段过渡到沙盒阶段时，面临首次 Hello World 的时间（TTFHW）问题。TTFHW 是需要跟踪的重要 API 指标之一，缩短此时间应始终是优先事项。多种因素可能会增加开发人员实现 Hello World 所需的时间。

这些潜在问题包括：

• API 错误
• SDK 中的错误
• 用户在实现 API 时的缺陷

通过 API 分析，可以跟踪 API 使用情况并观察开发人员的行为，发现他们在使用 API 时遇到的障碍。例如，某些开发人员是否在使用特定 API 端点后访问了文档页面？利用这些数据改进文档，使其更加相关和实用。为帮助开发人员更快地实现 Hello World，应提供有关 API 的相关内容和帮助。

有些用户可能永远无法实现 Hello World，这也是 TTFHW 成为重要跟踪指标的原因之一，因为它可能预示开发人员流失。需要了解 API 用户面临的具体困难，并帮助他们保持在正确轨道上。使用 API 分析创建漏斗并标记操作，不仅指示成功的 Hello World，还能显示多次调用的迹象。

许多 API 产品经理可能停留在 Hello World 阶段，而未进一步探索更深层次的成功指标。有时，这些信号更依赖于手动操作，如销售对话。通过分析跨多个端点的使用情况，可以鼓励开发人员采用更多 API 功能。

鼓励使用更多 API 功能和端点

开发人员通常从几个核心端点开始，往往不完全了解 API 提供的全部功能。为了应用程序的长期成功，通常需要在 API 的不同区域进行集成。利用 API 分析可以跟踪哪些端点未得到足够关注，并通过触发式电子邮件和内容营销向开发人员介绍整个 API。

例如，可以向用户发送一封电子邮件，包含指向产品页面、文档或简短视频的链接，介绍特定且未被使用的端点的优势。同时提供说明，阐述应用程序将如何从这些端点的功能中获益。通过定期发送自动电子邮件，向开发人员介绍新功能和未使用的端点，鼓励他们使用更多 API 功能。

另一个识别深层集成的方法是通过 SDK。可以提取 API 标头数据，了解每个标头的使用情况，并进一步分析，以确定产品是否已集成到活跃项目中。

获得 API 分析数据后，可以通过多种方式进行解读。除了跟踪开发人员的使用情况外，这些数据还可以用于做出更好的 API 产品决策。

利用数据做出更好的 API 产品决策

了解整个开发人员旅程后，可以根据实际的 API 使用情况做出更明智的产品决策。通过分析 API 的“热点”区域和较少使用的部分，可以规划未来的更新。作为一个相对新的领域，API 产品管理需要能够回答独特问题的工具。例如，可以关注以下问题：

• 按 API 使用情况排名靠前的客户
• 每个客户使用的端点
• 端点弃用的影响
• 哪些营销渠道推动了实际的 API 使用

借助这些数据（以及其他可能需要的数据），可以更加自信地评估当前结果并进行产品更新。考虑完整的开发人员旅程时，可以重新审视指标，以帮助更多开发人员不仅迈出关键的第一步，还能更全面地将 API 集成到他们的系统中。

原文链接：https://dzone.com/articles/api-analytics-across-the-developer-journey-1