
使用這些基本 REST API 最佳實踐構建出色的 API
我們的一批成熟的 API 優先公司使用Tableau或者旁觀者儀表板顯示有多少人正在注冊,其中有多少人正在登錄,其中有多少人正在創建應用程序,以及其中有多少個應用程序正在創建 API 令牌。為了使 Tableau 和 Looker 儀表板運行得更快,您可以清除設備上的緩存。您可以了解有關它的更多信息這里。
PM 的 OKR 主要致力于提高開發人員的激活率并確保縮短激活時間。由于開發人員可能會在單個漏斗階段停留數天甚至更長時間,因此跟蹤每個步驟的轉化率以及到達下一步所需的時間非常重要。
如果正常銷售周期為 90 天,則 PM 喜歡查看四分位數:第五十四分位數在做什么,第七十五四分位數在做什么,然后他們使用它作為代理來確定他們的 SDK 和文檔有多大用處。
一旦 API 被采用,PM 希望看到使用量增加,從而導致付費計劃、突出顯示熱門端點以及識別缺失功能的能力。在此階段,客戶的購買動向根據其公司規模分為兩類:大型企業或中小型企業/初創公司。
大多數情況下,領導層都會要求大多數開發人員評估 API 產品的可能性。有時,他們會創建一個開發人員組織并試用所有功能。然后,當他們的公司決定簽署協議時,他們實際上最終會提供一個單獨的帳戶。將開發人員組織映射到付費帳戶,并將收入帳戶綁定到 Salesforce 中,并不總是非常清晰。因此,PM 有時不會嘗試解決該映射問題,而是只關注更多的采用,因為采用是客戶是否會使用該產品的一個很好的指標。
大多數公司認為,在面向用戶的控制臺中跟蹤活動有助于提高使用率和參與度。當客戶注冊、配置帳戶、管理可用的 API 或打開和關閉功能時,他們會通過管理 Web 界面。如果您的 API 監控工具不是以用戶為中心的(即它無法深入研究 API 調用并識別其所屬的用戶和公司),那么 PM 必須部署分析工具,例如堆或者Google Analytics 360. 然后配置這些工具,將 Web 界面上的用戶與其組織中的其他人可能進行的 API 調用關聯起來。
然后,PM 可以跟蹤營銷渠道對相應 Google 或 Facebook 廣告的歸因。他們可以從創建帳戶開始,一直跟蹤到客戶轉換為付費計劃,再到他們首次開始進行 API 調用。
在 Moesif 等以用戶為中心的工具中,UTM 參數的監控方式與 HTTP 狀態響應代碼的監控方式相同。這樣就可以按 UTM 源或 UTM 活動對 API 令牌進行分組,從而更好地了解哪些營銷渠道有助于提高參與度。
每周活躍令牌(WAT) 是產品經理用來跟蹤其產品的最佳北極星指標之一,即每周訪問 API 的不同令牌數量。與與工程目標一致的基礎設施指標(如正常運行時間、SLO 或每分鐘請求數)不同,WAT 與推動采用和增加參與度的業務目標直接相關。要計算 WAT,數據基礎設施團隊需要從 Redshift 中提取相關的系統日志事件并將其傳遞到 Snowflake。到達那里后,BI 團隊編寫 SQL 查詢并在 Tableau 中將其可視化。
由于單個開發者帳戶可以創建多個 API 令牌(例如用于沙盒和生產環境),因此更準確的衡量標準是“每周活躍用戶”或“每周活躍公司”。但是,這需要能夠將 API 令牌鏈接到相應用戶或公司帳戶的分析基礎架構。
“讓邀請他人變得簡單”
一些 PM 發現,賬戶轉換和用戶數量之間存在直接關聯。用戶越多通常意味著客戶對項目越認真。因此,PM 會盡力邀請其他人加入注冊流程,比如說“邀請其他人加入此項目來幫助您完成工作”。通常,額外的好處是,這是另一個從用戶那里獲得公司電子郵件的機會,因為邀請者可能不知道受邀者的 Gmail,但會知??道他們的工作電子郵件。
在自助購買活動中,客戶是一個獨立的開發人員,在一個擁有 5 人或 10 人的初創公司或中小型企業,他只需輸入 CTO 信用卡即可立即開始使用付費服務。
由于大多數開發人員更喜歡自助服務方式,因此很難從該群體獲得超出 PM 為企業帳戶所做工作的額外見解。
“這不是絕對的說法,但大多數開發人員不想和你說話,他們不愿意和銷售人員交談,也不想回復電子郵件。事實上,他們經常使用個人電子郵件注冊,試圖隱藏他們為誰工作,”舊金山的 PM 說。
然而,通過觀察開發人員在產品中使用了什么、他們點擊了什么、他們進行了哪些 API 調用以及他們在 GitHub 上的 API SDK 的使用情況統計數據,可以在一定程度上了解開發人員的情緒。
在項目經理對采用和參與度有了很好的理解后,他們開始研究 API 產品留存率,以找到需要改進的領域。產品留存率是一個源于收入留存率的概念,需要將用戶群細分為群組,例如通過注冊日期。項目經理會跟蹤每個群組返回與您的平臺互動的百分比。在下面的示例中,API 留存率按用戶的 SDK 分組。您可以看到 PHP 的留存率遠低于其他 SDK,這意味著 PHP 存在錯誤,或者存在需要修復的性能問題。
確定要添加或棄用哪些產品功能的另一種方法是查看計費 SKU。許多 API 被分為一組 SKU,每種不同的活動類型都分配有自己的單個 SKU。通過查看誰為哪些功能付費,可以確定哪些功能正在使用,哪些功能沒有使用。
從項目經理的角度來看,監控商業智能的速度無疑是一個問題。
一位不滿的總理表示:“從提出新指標請求到得到統計數據,需要花太長時間。”
設置指標跟蹤的過程分為五個步驟。它涉及向單獨的 BI 團隊發出請求,然后該團隊必須對請求進行分類,然后將其納入,并且通常涉及談判和政治。代表性步驟包括:1) 所討論的數據是否有事件?2) 如果答案是肯定的,那么它是否在數據倉庫中?如果答案是否定的,那么數據基礎設施團隊中的某個人需要創建一個新的系統日志事件,然后將其納入。3) 創建指標在 Tableau 中可視化的方式的要求或更改報告。4) BI 數據團隊必須執行請求。5) 如果 BI 因太忙或超出其能力而無法將其可視化,那么 PM 將不得不要求工程部門對數據庫本身進行自定義 SQL 查詢。
一位安全行業領導者的 PM 這樣說道:“PM 永遠不會拒絕更具可操作性或更靈活的報告工具集。”
在我們采訪的許多公司中,他們從頭開始組建 DevEx 團隊,只是采用 BI 團隊使用的任何工具。由于沒有現成的選項,因此構建了對數據倉庫的自定義查詢。但從那時起,工具已經取得了長足的進步。
如今,像 Moesif 這樣的 API 分析工具可以幫助 API 驅動型組織中的每個人從他們的 API 數據中學習,并做出推動增長的更明智的決策。
我們正處于這樣一個階段:API 優先型公司的生產經理認識到,好的工具可以讓他們獲得有關開發人員成功的獨特見解,并且對于企業成功而言,其重要性不亞于可靠的 SDK 或完整的文檔。