外部動作設定

外部動作可讓Journey Optimizer B2B edition中的帳戶歷程直接從歷程畫布連線外部系統。 當帳戶對象到達外部動作節點時,系統會非同步呼叫已設定的外部服務,傳遞帳戶、人員或兩者的對象屬性資料。 外部服務使用回呼處理資料及回應,傳回可用於引導歷程執行的對象資料及中繼資料。

此功能支援兩種歷程節點型別:

  • 外部動作 — 呼叫外部服務並沿著單一傳出路徑繼續。 適合​ 引發並忘記 ​整合,例如更新CRM記錄或觸發下游通知。
  • 外部分割路徑 — 呼叫外部服務並評估回應,以沿著數個已定義的路徑之一路由帳戶。
NOTE
僅帳戶歷程支援外部動作服務。 這些節點型別不適用於個人歷程。

實施概述

設定外部動作需要依序在三個角色之間進行協調:

實作外部服務 implement-service

開發人員必須建立並發佈符合Adobe Journey Optimizer B2B edition外部動作服務提供者介面的公開顯示網頁服務。

NOTE
回呼函式需要持有人權杖。 請在Adobe Developer Console🔗中為您的IMS組織設定OAuth伺服器對伺服器認證,以擷取此專案。

服務上線後,將OpenAPI規格的URL和驗證認證提供給負責設定動作的產品管理員。

設定動作 configure-action

必須先設定並啟動動作,行銷人員才能在歷程中使用。 動作以​ 草稿 ​狀態建立,且您的變更會自動儲存。 在您啟動它之前,它一直保持為草稿。

PREREQUISITES
在新增設定之前,請先向開發人員取得OpenAPI規格的URL和驗證認證。
若要定義及啟用外部動作,您必須擁有​_管理B2B管理組態_ 產品許可權
  1. 移至​管理 > 組態

  2. 按一下中繼面板上的​外部動作

    存取外部動作設定空間 {width="800" modal="regular"}

  3. 按一下右上角的​建立動作

  4. 輸入外部服務的OpenAPI規格URL,然後按一下​建立

    輸入服務URL {width="500"}

    note note
    NOTE
    您的外部服務必須為即時狀態且可連線,此步驟才能成功。
  5. 當URL成功解析時,請檢閱​服務詳細資料

    建立動作時,會直接從OpenAPI規格讀取服務詳細資料。 建立後,您無法在設定中變更這些屬性。

    table 0-row-3 1-row-3 2-row-3 3-row-3
    屬性 說明 OpenAPI規格屬性
    名稱 動作的名稱 info.title
    說明 動作的說明 info.description
    URL 定義外部服務的OpenAPI規格的URL servers.url
  6. 輸入外部服務(components.securitySchemes)的​ 驗證 ​認證。

    note note
    NOTE
    顯示的認證欄位取決於外部服務中定義的驗證機制。 支援的型別為API金鑰、OAuth2和HTTP基本驗證。

    新增驗證認證 {width="600" modal="regular"}

    當設定的動作處於​ 草稿 ​或​ 作用中 ​狀態時,您可以視需要變更認證。

  7. 按一下​下一步

  8. 設定​ 組態 ​屬性以定義動作與外部服務交換資料的方式。

    note note
    NOTE
    標示為​_靜態_​的屬性在設定時不可更新,而且是以服務定義為基礎。
    • 動作型別靜態) — 支援的歷程節點型別:

      • 外部動作 (enableSplitPath = false)
      • 外部動作分割路徑 (enableSplitPath = true)

      建立動作設定後,您無法變更動作型別。

    • 存取子靜態) — (僅限外部動作分割路徑)外部服務傳回的變數可用作外部分割路徑節點中的路徑條件。 (invocationPayloadDef.accessorsMetadata)

    • 歷程內容靜態) — 要求中傳送的對象資料範圍(supportedEntityType):

      • 帳戶 — 僅傳送帳戶

      • 人員 — 僅傳送人員

      • 帳戶中的人員 — 傳送帳戶和與帳戶相關的人員

    • 傳出欄位 — 將表格中的每個欄位對應到XDM欄位。 這些欄位會在要求內文中傳送給外部服務。 服務定義屬性: invocationPayloadDef.accountFieldsinvocationPayloadDef.fields

    對應外部動作傳出欄位 {width="600" modal="regular"}

    • 傳入欄位 — 將資料表中的每個欄位對應到可更新的XDM欄位。 這些欄位會從外部服務回應填入。 服務定義屬性: callbackPayloadDef.accountFieldscallbackPayloadDef.fields。 建立後可更新。

    • 標頭引數 — 輸入每個資料列的值,以作為要求中的HTTP標頭傳遞。 服務定義屬性: invocationPayloadDef.headers

    • 逾時 — 輸入在要求被視為失敗之前,等待外部服務呼叫回呼的分鐘數。 服務定義屬性: timeout

    • 全域屬性 — 輸入每個資料列的值,以做為要求內文中的靜態欄位。 服務定義屬性: invocationPayloadDef.globalAttributes

    外部動作標頭引數、逾時和全域屬性 {width="600" modal="regular"}

  9. 按一下​ 上一箭號 ​以返回清單並將動作保持在​ 草稿 ​狀態。

    或者,按一下[啟動]​ ​將動作組態變更為[啟動]__​狀態。 設定的外部動作必須處於作用中狀態,才能用於帳戶歷程。

將外部節點新增至歷程 add-journey-node

動作啟動後,行銷人員可以將​ 外部動作 ​或​ 外部分割路徑 ​節點新增至任何帳戶歷程。 如需如何在帳戶歷程畫布中新增及使用這些節點的詳細資訊,請參閱外部節點

recommendation-more-help
6ef00091-a233-4243-8773-0da8461f7ef0