例如，使用傳統(tǒng)的 Web 分析方法可能會(huì)誤導(dǎo)組織，使其誤以為 API 調(diào)用量很高，僅僅因?yàn)?API 被廣泛訪問。然而，實(shí)際情況可能是訪問者經(jīng)常遇到錯(cuò)誤，或者某些終端節(jié)點(diǎn)盡管訪問量少，但每次訪問時(shí)間較長(zhǎng)。如果開發(fā)團(tuán)隊(duì)沒有構(gòu)建 API 分析工具的經(jīng)驗(yàn)，他們可能無法有效地創(chuàng)建和維護(hù)這些工具。
此外，開發(fā)內(nèi)部分析工具意味著將資源從核心產(chǎn)品的開發(fā)轉(zhuǎn)移到分析工具的開發(fā)上。這不僅會(huì)延長(zhǎng)產(chǎn)品開發(fā)周期，還可能導(dǎo)致開發(fā)團(tuán)隊(duì)的壓力增大。因此，開發(fā)人員可能更傾向于集中精力在產(chǎn)品本身，而不是分析工具的構(gòu)建上。
在構(gòu)建 API 分析工具時(shí)，內(nèi)部團(tuán)隊(duì)常常面臨報(bào)告積極指標(biāo)的壓力。為了激勵(lì)團(tuán)隊(duì)成員、向投資者展示成功以及用于營(yíng)銷目的，許多組織會(huì)要求提供良好的指標(biāo)。這種壓力常常導(dǎo)致高技能的開發(fā)團(tuán)隊(duì)報(bào)告看似令人印象深刻但實(shí)際上不反映 API 成功程度的表面指標(biāo)。
盡管分享呈現(xiàn)上升趨勢(shì)的圖表很誘人，但有用的指標(biāo)應(yīng)超越簡(jiǎn)單的 API 請(qǐng)求數(shù)量，除非能夠?qū)⒄{(diào)用直接與收入掛鉤。應(yīng)關(guān)注 API 的整體運(yùn)行狀況和成功，例如延遲改進(jìn)如何影響開發(fā)人員體驗(yàn)。
許多組織定義了錯(cuò)誤的成功指標(biāo)，這導(dǎo)致對(duì) API 實(shí)現(xiàn)目標(biāo)的成功情況產(chǎn)生誤解。表面指標(biāo)容易被創(chuàng)建，尤其是在面向開發(fā)人員的產(chǎn)品中。此類產(chǎn)品和服務(wù)通常側(cè)重于開發(fā)時(shí)間、首次使用的用戶數(shù)量或預(yù)置的 API 密鑰數(shù)量。這些指標(biāo)并未能有效反映 API 的開發(fā)人員體驗(yàn)、為開發(fā)人員創(chuàng)造的價(jià)值或與公司整體目標(biāo)的契合度。
在討論了內(nèi)部 API 分析工具的挑戰(zhàn)及其可能導(dǎo)致的表面指標(biāo)之后，現(xiàn)在我們來關(guān)注一些關(guān)鍵指標(biāo)，以了解 API 的性能及其對(duì)業(yè)務(wù)目標(biāo)的貢獻(xiàn)。首先，我們需要關(guān)注 API 用戶的開發(fā)人員體驗(yàn)。
開發(fā)人員體驗(yàn)從他們注冊(cè)使用 API 的那一刻開始。應(yīng)當(dāng)跟蹤每位開發(fā)人員的整個(gè)使用過程，包括他們最初注冊(cè)、生成第一個(gè) API 密鑰、首次 API 調(diào)用以及最早的 API 交易的長(zhǎng)度和內(nèi)容。這些數(shù)據(jù)能夠提供有關(guān) API 開發(fā)人員體驗(yàn)的寶貴信息，包括：
這些信息幫助進(jìn)一步優(yōu)化 API，提供及時(shí)的支持，以改善開發(fā)人員體驗(yàn)。此外，還可以分析來自不同渠道的用戶是否更可能達(dá)到特定的 API 使用水平。
從中期來看，這可以幫助跟蹤 API 對(duì)開發(fā)人員的留存情況，這是評(píng)估 API 價(jià)值的重要方面。您將能夠了解哪些終端節(jié)點(diǎn)的事務(wù)數(shù)量最高，以及典型事務(wù)的持續(xù)時(shí)間，從而決定資源的重點(diǎn)投入方向。
跟蹤 API 指標(biāo)時(shí)應(yīng)包含唯一標(biāo)識(shí)符，以便更容易監(jiān)控單個(gè)客戶的使用數(shù)據(jù)。這不僅能幫助了解 API 性能，還能使客戶支持迅速高效。客戶使用情況是衡量業(yè)務(wù)價(jià)值的關(guān)鍵指標(biāo)，因此持續(xù)跟蹤 API 交易非常重要，以便清晰地了解 API 是否滿足了客戶需求。
客戶也關(guān)心其使用情況隨時(shí)間的變化。應(yīng)向每個(gè)客戶提供他們的使用信息，以便他們了解何時(shí)接近配額限制，避免超出配額。同時(shí)，他們可能希望知道在訪問 API 時(shí)通常消耗多少網(wǎng)絡(luò)資源，這有助于他們合理分配資源。了解最常用或數(shù)據(jù)傳輸最多的終端節(jié)點(diǎn)對(duì)于客戶也很重要，因?yàn)檫@些信息可以告知他們哪些終端節(jié)點(diǎn)提供了最大的業(yè)務(wù)價(jià)值。這樣可以提升客戶體驗(yàn)，增加他們對(duì) API 的使用頻率。
從長(zhǎng)遠(yuǎn)來看，擴(kuò)展 API 分析是一個(gè)重要方面。隨著客戶數(shù)量的增加，API 調(diào)用次數(shù)、調(diào)用長(zhǎng)度和內(nèi)容也會(huì)增長(zhǎng)。雖然準(zhǔn)確執(zhí)行 API 分析具有挑戰(zhàn)性，但隨著時(shí)間推移和 API 事務(wù)數(shù)量的增加，這一挑戰(zhàn)會(huì)更加嚴(yán)峻。因此，API 分析實(shí)施需要準(zhǔn)確跟蹤業(yè)務(wù)價(jià)值，并處理 API 的增長(zhǎng)。
構(gòu)建準(zhǔn)確的 API 分析工具非常困難。即使是經(jīng)驗(yàn)豐富的團(tuán)隊(duì)也需要大量資源來進(jìn)行首次分析，并不斷開發(fā)指標(biāo)以獲取更詳細(xì)的信息。不過，這并不是放棄的理由。出色的 API 指標(biāo)將為業(yè)務(wù)帶來顯著價(jià)值，幫助改善客戶體驗(yàn)，并指導(dǎo)關(guān)注 API 的關(guān)鍵方面。
到目前為止，已介紹了組織在分析 API 時(shí)常遇到的陷阱、這些問題發(fā)生的原因以及應(yīng)關(guān)注的指標(biāo)。接下來，將對(duì)不同使用案例中的常見表面指標(biāo)和 API 事務(wù)指標(biāo)進(jìn)行直接比較。
API 采用率是許多組織重視的指標(biāo)，因此正確衡量它非常重要。常見的方法是查看已為 API 預(yù)置的 API 密鑰數(shù)量。這顯示了 API 的受歡迎程度和開發(fā)人員的興趣，但僅依賴這一指標(biāo)是有風(fēng)險(xiǎn)的。它只反映了有多少開發(fā)人員考慮使用您的 API，并不能告訴您他們是否成功進(jìn)行了第一次 API 調(diào)用、他們處于入門旅程的哪個(gè)階段，或他們遇到了多少錯(cuò)誤。相比之下，如果使用唯一標(biāo)識(shí)符跟蹤用戶留存情況，并監(jiān)測(cè)從創(chuàng)建 API 密鑰到首次成功調(diào)用（如 “Hello World!”）所需的時(shí)間，您可以更清楚地了解是否需要改進(jìn)入門文檔和支持。
了解 API 的實(shí)際情況可能具有挑戰(zhàn)性，但通過正確的分析工具，您可以為客戶創(chuàng)造最大價(jià)值，并有效跟蹤實(shí)現(xiàn)組織目標(biāo)的成功程度。
原文鏈接：Vanity Metrics for APIs vs Tracking Business Value From API Transactions