使用標準整合 external-sources

導覽至左側功能表中的​ 組態 ​區段，然後從​ 整合 ​卡片按一下​管理。

然後，按一下[建立整合] ​​以開始新的組態。

{modal="regular"}

選擇性地貼上​ cURL ​命令以自動填入URL、HTTP方法、標頭和查詢引數。

提供整合的​ 名稱 ​和​描述。

輸入API端點​URL。

對於路徑變數，在URL中以雙大括弧括住標籤，例如https://api.example.com/v1/products/{{productId}}，然後在​ 路徑引數 ​中設定每個預留位置。

選取​ 啟用瀏覽 ​以連結使用中的瀏覽整合，以便其回應欄位可以對應到標題、查詢和路徑引數以及承載中的變數。

➡️請參閱建立瀏覽整合

{modal="regular"}

為您在URL中新增的每個預留位置設定​ 路徑引數 ​的​ 名稱 ​和​預設值。

請注意，Name​僅是編輯器中面向行銷人員的標籤，不會根據API請求傳送。

{modal="regular"}

選取GET與POST之間的​HTTP方法。

視整合需要，按一下​ 新增標題 ​和/或​新增查詢引數。 針對每個引數，提供下列詳細資訊：

• 引數： API預期的實際標頭或查詢引數名稱。

• 名稱：此引數可供行銷人員使用的標籤，作者在對應行銷活動中的值時可加以選取。

• 型別：選擇固定值的​ 常數 ​或動態輸入的​變數。

• 值：直接輸入常數值，或選取變數對應。

• 必要：指定是否需要此引數。 對於強制的​ 變數 ​引數，如果未在執行階段解析任何值且未提供預設值，則產生請求會失敗並出現錯誤，且不會進行傳出API呼叫。

{modal="regular"}

選擇​驗證型別：

• 無驗證：適用於不需要任何認證的開放API。

• API金鑰：使用靜態API金鑰驗證請求。 輸入您的​ API金鑰名稱{1​}、 ​​ API金鑰值{3​}並指定您的​位置。​****

• 基本驗證：使用標準HTTP基本驗證。 輸入​ 使用者名稱 ​和​密碼。

• OAuth 2.0：使用OAuth 2.0通訊協定進行驗證。 按一下 圖示以設定或更新​裝載。

{modal="regular"}

設定API要求的​原則組態 （例如​ 逾時 ​期間），並選擇啟用節流、快取和/或重試。

對於​ POST ​方法，請選擇​ 主體型別 ​以設定​裝載：

• JSON：按一下 圖示並貼上您的JSON要求承載。 對應您必須在裝載中履行的變數。

• GraphQL：貼上您的GraphQL查詢。 Journey Optimizer會自動產生​作業名稱，並讓您對應對應的查詢變數。

  {modal="regular"}

選擇介於​ JSON ​和​ HTML ​之間的​回應型別。

透過​ 回應承載 ​欄位，您可以決定樣例輸出的哪些欄位需要用於訊息個人化。

按一下 圖示並貼上範例JSON回應裝載以自動偵測資料型別。

選擇要公開以進行個人化的欄位，並指定其對應的資料型別。

{modal="regular"}

定義URL、HTTP方法、標頭和查詢引數時，按一下[傳送測試連線] 以執行連線測試並確認組態。

在​ 傳送測試連線 ​對話方塊中，為URL路徑、標頭和查詢引數中的任何​ 變數 ​預留位置輸入預設值。

這些值會包含在測試請求中。 Journey Optimizer會叫用端點，並報告連線成功或失敗。

{modal="regular"}

如果測試傳回成功的回應，請選取​使用作為回應承載，將回應內文複製到​ 回應承載 ​欄位中，請參閱設定整合下的步驟10，其中可偵測資料型別，並可選取欄位進行個人化。

{modal="regular"}

如果測試不成功，請展開​ 錯誤 ​下拉式清單以檢閱失敗詳細資料，視需要更新整合組態，然後再次執行​傳送測試連線。

{modal="regular"}

驗證後，按一下​啟動。

存取您新建立的整合專案：

• 更新：僅變更​ 驗證 ​詳細資料和​原則組態。 更新適用於即時歷程和行銷活動。 在儲存變更之前，請使用​ 瀏覽參考 ​功能表來確認整合的使用位置。

• 封存：封存整合設定。

  {modal="regular"}

啟用後，請按一下 圖示以存取​ 探索參考 ​功能表，並檢閱此設定的使用狀況，包括相依的歷程與行銷活動。

{modal="regular"}