外部動作設定
外部動作可讓Journey Optimizer B2B edition中的帳戶歷程直接從歷程畫布連線外部系統。 當帳戶對象到達外部動作節點時,系統會非同步呼叫已設定的外部服務,傳遞帳戶、人員或兩者的對象屬性資料。 外部服務使用回呼處理資料及回應,傳回可用於引導歷程執行的對象資料及中繼資料。
此功能支援兩種歷程節點型別:
- 外部動作 — 呼叫外部服務並沿著單一傳出路徑繼續。 適合 引發並忘記 整合,例如更新CRM記錄或觸發下游通知。
- 外部分割路徑 — 呼叫外部服務並評估回應,以沿著數個已定義的路徑之一路由帳戶。
實施概述
設定外部動作需要依序在三個角色之間進行協調:
實作外部服務 implement-service
開發人員必須建立並發佈符合Adobe Journey Optimizer B2B edition外部動作服務提供者介面的公開顯示網頁服務。
服務上線後,將OpenAPI規格的URL和驗證認證提供給負責設定動作的產品管理員。
設定動作 configure-action
必須先設定並啟動動作,行銷人員才能在歷程中使用。 動作以 草稿 狀態建立,且您的變更會自動儲存。 在您啟動它之前,它一直保持為草稿。
-
移至管理 > 組態。
-
按一下中繼面板上的外部動作。
{width="800" modal="regular"}
-
按一下右上角的建立動作。
-
輸入外部服務的OpenAPI規格URL,然後按一下建立。
{width="500"}
note note NOTE 您的外部服務必須為即時狀態且可連線,此步驟才能成功。 -
當URL成功解析時,請檢閱服務詳細資料。
建立動作時,會直接從OpenAPI規格讀取服務詳細資料。 建立後,您無法在設定中變更這些屬性。
table 0-row-3 1-row-3 2-row-3 3-row-3 屬性 說明 OpenAPI規格屬性 名稱 動作的名稱 info.title說明 動作的說明 info.descriptionURL 定義外部服務的OpenAPI規格的URL servers.url -
輸入外部服務(
components.securitySchemes)的 驗證 認證。note note NOTE 顯示的認證欄位取決於外部服務中定義的驗證機制。 支援的型別為API金鑰、OAuth2和HTTP基本驗證。 {width="600" modal="regular"}
當設定的動作處於 草稿 或 作用中 狀態時,您可以視需要變更認證。
-
按一下下一步。
-
設定 組態 屬性以定義動作與外部服務交換資料的方式。
note note NOTE 標示為_靜態_的屬性在設定時不可更新,而且是以服務定義為基礎。 -
動作型別 (靜態) — 支援的歷程節點型別:
- 外部動作 (
enableSplitPath= false) - 外部動作分割路徑 (
enableSplitPath= true)
建立動作設定後,您無法變更動作型別。
- 外部動作 (
-
存取子 (靜態) — (僅限外部動作分割路徑)外部服務傳回的變數可用作外部分割路徑節點中的路徑條件。 (
invocationPayloadDef.accessorsMetadata) -
歷程內容 (靜態) — 要求中傳送的對象資料範圍(
supportedEntityType):-
帳戶 — 僅傳送帳戶
-
人員 — 僅傳送人員
-
帳戶中的人員 — 傳送帳戶和與帳戶相關的人員
-
-
傳出欄位 — 將表格中的每個欄位對應到XDM欄位。 這些欄位會在要求內文中傳送給外部服務。 服務定義屬性:
invocationPayloadDef.accountFields,invocationPayloadDef.fields。
{width="600" modal="regular"}
-
傳入欄位 — 將資料表中的每個欄位對應到可更新的XDM欄位。 這些欄位會從外部服務回應填入。 服務定義屬性:
callbackPayloadDef.accountFields,callbackPayloadDef.fields。 建立後可更新。 -
標頭引數 — 輸入每個資料列的值,以作為要求中的HTTP標頭傳遞。 服務定義屬性:
invocationPayloadDef.headers。 -
逾時 — 輸入在要求被視為失敗之前,等待外部服務呼叫回呼的分鐘數。 服務定義屬性:
timeout。 -
全域屬性 — 輸入每個資料列的值,以做為要求內文中的靜態欄位。 服務定義屬性:
invocationPayloadDef.globalAttributes。
{width="600" modal="regular"}
-
-
按一下 上一箭號 以返回清單並將動作保持在 草稿 狀態。
或者,按一下[啟動] 將動作組態變更為[啟動]__狀態。 設定的外部動作必須處於作用中狀態,才能用於帳戶歷程。
將外部節點新增至歷程 add-journey-node
動作啟動後,行銷人員可以將 外部動作 或 外部分割路徑 節點新增至任何帳戶歷程。 如需如何在帳戶歷程畫布中新增及使用這些節點的詳細資訊,請參閱外部節點。