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