與外部系統整合 external-systems

本頁介紹Journey Orchestration在整合外部系統時提供的各種護欄，以及最佳實務：如何使用上限API最佳化外部系統的保護、如何設定歷程逾時，以及重試如何運作。

Journey Orchestration可讓您透過自訂資料來源和自訂動作來設定與外部系統的連線。 舉例來說，這可讓您利用來自外部訂房系統的資料，或利用第三方系統(例如Epsilon或Facebook)傳送訊息，讓您的歷程更為豐富。

整合外部系統時，您可能會遇到幾個問題：系統可能緩慢、停止回應，或是可能無法處理較大的磁碟區。 Journey Orchestration提供數個護欄，可保護您的系統避免過載。

所有外部系統的效能都不同。 您需要調整設定以符合使用案例。

當Journey Orchestration執行對外部API的呼叫時，技術護欄會以下列方式執行：

頻率限定 capping

內建的上限API提供上游技術護欄，可協助保護您的外部系統。

對於外部資料來源，每秒呼叫數上限設為15。 如果通話次數超過每秒15次，則會捨棄剩餘的通話。 您可以提高私人外部資料來源的此限制。 聯絡Adobe以在允許清單中包含端點。 公開外部資料來源無法執行此操作。

對於自訂動作，您需要評估外部API的容量。 例如，如果Journey Optimizer每秒傳送1000個呼叫，而您的系統僅支援每秒100個呼叫，則您需要定義上限規則，讓系統不會飽和。

上限規則是在特定端點（呼叫的URL）的沙箱層級定義。 在執行階段，Journey Orchestration會驗證是否已定義上限規則，並在呼叫該端點期間套用定義的速率。 如果呼叫數超過定義的速率，則會捨棄剩餘的呼叫，並在報表中計為錯誤。

上限規則專用於一個端點，但沙箱的所有歷程是全域的。 這表示沙箱的所有歷程會共用限定槽。

例如，假設您已為外部系統定義每秒100次呼叫的上限規則。 10 個不同歷程的自訂動作會呼叫您的系統。 如果某個歷程每秒接聽200次呼叫，就會使用可用的100個位置並捨棄剩餘的100個位置。 由於已超過最大速率，其他 9 個歷程將沒有任何插槽。 此詳細程度有助於保護外部系統免於過載及損毀。

若要進一步瞭解上限API以及如何設定上限規則，請參閱此頁面。

逾時和重試 timeout

如果符合上限規則，則會套用逾時規則。

在每個歷程中，您可以定義逾時持續時間。 這可讓您設定呼叫外部系統時的最長持續時間。 逾時期間是在歷程的屬性中設定。 請參見此頁面。

此逾時對於所有外部呼叫（自訂動作和自訂資料來源中的外部API呼叫）都是全域的。 預設會設為5秒。

在定義的逾時期間，Journey Orchestration會嘗試呼叫外部系統。 在第一次呼叫後，最多可以執行三次重試，直到逾時持續時間結束為止。 無法變更重試次數。

每個重試使用一個插槽。 如果您有每秒100次呼叫的上限，且您的每個呼叫需要重試兩次，則速率會降至每秒30次呼叫（每個呼叫使用3個槽：第一次呼叫和兩次重試）。

逾時期間值取決於使用案例。 如果您想要快速傳送訊息（例如，當使用者端進入商店時），則您不想設定漫長的逾時。 此外，逾時時間越長，放入佇列中的專案就越多。 這可能會大幅影響效能。 如果Journey Orchestration每秒執行1000次呼叫，保留5或15秒的資料會迅速讓系統不知所措。

以逾時5秒為例。

常見問答 faq

如何設定上限規則？ 是否有預設的上限規則？

依預設，沒有上限規則。 上限規則是使用上限API，在特定端點（呼叫的URL）的沙箱層級定義。 請參閱此章節和此頁面。

執行多少次重試？ 我可以變更重試次數或定義兩次重試之間的最短等待時間嗎？

對於指定的呼叫，在第一次呼叫之後最多可以執行三次重試，直到逾時持續時間結束為止。 無法變更重試次數和每次重試之間的時間。 請參閱本節。

我可以在哪裡設定逾時？ 有最大值嗎？

在每個歷程中，您可以定義逾時持續時間。 逾時期間是在歷程的屬性中設定。 逾時持續時間必須介於1秒到30秒之間。 請參閱此章節和此頁面。