Marketo整合最佳實務
圍繞您的Marketo執行個體的共用API限制設計整合。 使用批次處理程式、快取和保守的請求率來改善輸送量和可靠性。
API限制
- 每日配額：大部分的訂閱每天都會分配50,000個API呼叫。 配額會在每日中午12:00 CST重設。 請連絡您的帳戶管理員以增加每日配額。
- 速率限制：每個執行個體限製為每20秒100次API呼叫。
- 並行限制：每個執行個體最多允許10個並行API呼叫。
- 批次大小：潛在客戶資料庫支援300筆記錄；資產查詢支援200筆記錄。
- REST API承載大小： 1 MB。
- 大量匯入檔案大小： 10 MB。
- SOAP批次大小上限： 300筆記錄。
- 大量擷取工作：兩個正在執行，10個已排入佇列（含）。
快速提示
- 設定保守使用量限制，因為您的應用程式會與其他應用程式共用配額、比率及並行資源。
- 可用時，請使用Marketo大量和批次方法。 僅在必要時使用單一記錄或單一結果呼叫。
- 使用指數回退，重試因速率或並行限制而失敗的API呼叫。
- 避免同時API呼叫，除非讓您的使用案例受益。
批次處理程式
對於插入和更新，請將記錄分組到儘可能少的交易中。 從資料存放區擷取記錄時，請在提交前彙總記錄，而非針對每次變更提交一個請求。
可接受的延遲
當您設計整合時，定義可接受的延遲時間，即提交API呼叫之前的最長時間。 此選項會決定哪些Marketo方法和設定選項適合使用案例。
例如，即時整合可在使用者開始試用時通知銷售人員，當需要立即後續追蹤時，可能會提交批次一個。 大部分的使用案例可以容許更多延遲，並透過佇列和批次呼叫來更有效率地運作。
每日限制
每個啟用API的Marketo執行個體每天至少會配置10,000個REST API呼叫，但通常為50,000個或更多。 每個執行個體也有500 MB以上的大量擷取容量。 額外的每日容量可作為Marketo訂閱的一部分購買，但應用程式設計應考慮常見的訂閱限制。
容量由執行個體中的所有API服務和使用者共用。 儘可能將多餘的呼叫和批次記錄排除到少數呼叫中。
最有效率呼叫的匯入方法是Marketo大量匯入API，可供銷售機會/人員和自訂物件使用。 Marketo也為銷售機會和活動提供大量擷取。
快取
下列作業的結果通常可以在使用者端快取一天以上，因為它們很少變更：
若是銷售機會或活動資料擴充等使用案例，您也可以快取方案、電子郵件和資料夾等資產型別。
速率限制
每個Marketo例項的所有協力廠商API服務具有每20秒100次呼叫的共用速率限制。 如果呼叫超過此限制，API會傳回606錯誤代碼。
一般而言，請將每個協力廠商整合限製為每20秒50次呼叫，以便多個API整合和使用者可以共用可用容量。 部分使用案例可能需要完整的限制。 不過，使用批次處理和目標較低輸送量的應用程式通常能更迅速回應、更一致，延遲也只會稍微增加。
並行限制
每個Marketo例項都有可同時執行REST API呼叫的10個共用限制。 請勿假設您的應用程式是此限制的唯一消費者。
Marketo會計算正在處理且尚未傳回的呼叫。 呼叫傳回時，不再計入並行限制。
大部分的整合功能不會受益於並行呼叫。 如果您實作並行處理，一開始會將應用程式限製為五個或更少的並行請求。 只有在您判斷應用程式需要更多專案後，才提高上限。
錯誤次數
除了極少數情況外，API請求會傳回HTTP狀態代碼200。 商業邏輯錯誤也會傳回200，但會在回應主體中包含詳細資訊。 如需詳細資訊，請參閱錯誤碼。
請勿評估HTTP原因片語，因為它是選用字詞，而且可能會有所變更。