設定自訂動作 configure-an-action

如果您使用協力廠商系統來傳送訊息,或想要歷程傳送API呼叫至協力廠商系統,請使用自訂動作來設定其與您歷程的連線。 例如,您可以使用自訂動作連線到下列系統:Epsilon、Slack、 Adobe Developer、Firebase等

自訂動作是技術使用者定義的其他動作,可供行銷人員使用。 設定後,其會顯示在您歷程的左側浮動視窗中,位於 動作 類別。 在本頁中瞭解更多。

限制 custom-actions-limitations

自訂動作隨附下列幾項限制 此頁面.

在自訂動作引數中,您可以傳遞簡單集合以及物件集合。 進一步瞭解中的集合限制 此頁面.

另請注意,自訂動作引數採用預期格式(例如:字串、小數等)。 您必須注意遵守這些預期的格式。 在本節瞭解更多 使用案例.

自訂動作僅在使用時支援JSON格式 請求回應裝載.

最佳作法 custom-action-enhancements-best-practices

使用自訂動作選擇要作為目標的端點時,請確定:

  • 此端點可使用來自節流 API設定 API 上限的設定來支援歷程的輸送量,藉此加以限制。 請留意,節流設定不可低於 200 TPS。任何目標端點至少需要支援 200 TPS。
  • 此端點的回應時間必須儘可能縮短。 根據預期輸送量,高回應時間可能會影響實際輸送量。

所有自訂動作皆已定義1分鐘上300,000次呼叫的上限。 此外,預設上限會針對每個主機和每個沙箱執行。 例如,在沙箱上,如果您有主機相同的兩個端點 (例如:https://www.adobe.com/endpoint1https://www.adobe.com/endpoint2),此上限會套用至 adobe.com 主機下的所有端點。 「endpoint1」和「endpoint2」會共用相同的上限設定,而且讓一個端點達到限制會影響到另一個端點。

此限制是根據客戶使用情況來設定,可保護自訂動作鎖定為目標的外部端點。您需要定義適當的讀取率 (使用自訂動作時為每秒 5000 個設定檔),以在對象歷程中將其列入考量。 如有需要,您可以透過上限/節流 API 定義較高的上限或節流限制來覆寫此設定。 請參閱此頁面

基於以下各種原因,您不應使用自訂動作來鎖定公用端點:

  • 如果沒有適當的上限或節流,可能會傳送過多呼叫至可能不支援此磁碟區的公用端點。
  • 設定檔資料可透過自訂動作傳送,因此定位公用端點可能會導致無意間在外部共用個人資訊。
  • 您無法控制公用端點傳回的資料。 如果端點變更其API或開始傳送不正確的資訊,這些資訊將可在傳送的通訊中使用,並可能產生負面影響。

同意與資料控管 privacy

在Journey Optimizer中,您可以將資料控管和同意原則套用至自訂動作,以防止特定欄位匯出至協力廠商系統,或排除尚未同意接收電子郵件、推播或簡訊通訊的客戶。 如需詳細資訊,請參閱下列頁面:

設定步驟 configuration-steps

以下是設定自訂動作所需的主要步驟:

  1. 在「管理」功能表區段中,選取 設定. 在 動作 區段,按一下 管理. 按一下 建立動作 以建立新動作。 動作設定窗格會在畫面右側開啟。

  2. 輸入動作的名稱。

    note note
    NOTE
    只允許使用英數字元和底線。 長度上限為30個字元。
  3. 新增說明至您的動作。 此步驟為選填。

  4. 使用此動作的歷程次數會顯示在 使用位置 欄位。 您可以按一下 檢視歷程 按鈕來顯示使用此動作的歷程清單。

  5. 定義不同的 URL設定 引數。 請參閱此頁面

  6. 設定 驗證 區段。 此設定與資料來源的設定相同。 另請參閱 本節.

  7. 定義 動作引數. 請參閱此頁面

  8. 按一下​ 儲存

    自訂動作現已設定完畢,且可供您在歷程中使用。 請參閱此頁面

    note note
    NOTE
    當歷程中使用自訂動作時,大部分引數均為唯讀。 您只能修改 名稱說明URL 欄位和 驗證 區段。

端點設定 url-configuration

設定自訂動作時,您需要定義下列專案 端點設定 引數:

  1. URL 欄位,指定外部服務的URL:

    • 如果URL是靜態的,請在此欄位中輸入URL。

    • 如果URL包含動態路徑,請只輸入URL的靜態部分,也就是配置、主機、連線埠,以及(選擇性)路徑的靜態部分。

      範例:https://xxx.yyy.com/somethingstatic/

      將自訂動作新增至歷程時,您將指定URL的動態路徑。 了解更多

    note note
    NOTE
    基於安全考量,我們強烈建議您針對URL使用HTTPS配置。 我們不允許使用非公開的Adobe位址和IP位址。
    定義自訂動作時只允許預設連線埠:80用於http,443用於https。
  2. 選取通話 方法:它可以 POSTGETPUT.

    note note
    NOTE
    DELETE 方法不受支援。 如果您需要更新現有資源,請選取 PUT 方法。
  3. 定義標頭和查詢引數:

    • 標頭 區段,按一下 新增標題欄位 定義要傳送給外部服務之要求訊息的HTTP標頭。 此 Content-Type字元集 標頭欄位預設為設定。 您無法刪除這些欄位。 僅限 Content-Type 標頭可以修改。 其值應符合JSON格式。 以下是預設值:

    • 查詢引數 區段,按一下 新增查詢引數欄位 以定義您要新增至URL的引數。

  4. 輸入欄位的標籤或名稱。

  5. 選取型別: 常數變數. 如果您已選取 常數,然後輸入中的常數值 欄位。 如果您已選取 變數,則您會在將自訂動作新增至歷程時指定此變數。 了解更多

    note note
    NOTE
    將自訂動作新增至歷程後,如果歷程處於草稿狀態,您仍可新增標題或查詢引數欄位至歷程。 如果您不希望歷程受設定變更影響,請複製自訂動作,並將欄位新增到新的自訂動作。
    標頭會根據欄位剖析規則進行驗證。 進一步瞭解 本檔案.

mTLS通訊協定支援 mtls-protocol-support

您現在可以使用相互傳輸層安全性(mTLS),確保對Adobe Journey Optimizer自訂動作的輸出連線具有增強的安全性。 mTLS是一種用於相互驗證的端對端安全性方法,可確保共用資訊的雙方在共用資料之前,都是聲稱的身分。 mTLS包括相較於TLS的額外步驟,其中伺服器也會要求使用者端的憑證並在其末端驗證它。

自訂動作支援雙向TLS (mTLS)驗證。 自訂動作或歷程中不需要額外設定即可啟用mTLS;偵測到啟用mTLS的端點時,會自動發生此情況。 了解更多

定義裝載引數 define-the-message-parameters

  1. 請求 區段,貼上要傳送至外部服務的JSON裝載範例。 此欄位是選用欄位,僅適用於POST和PUT呼叫方法。

  2. 回應 區段,貼上呼叫傳回之裝載的範例。 此欄位是選用欄位,可用於所有呼叫方法。 如需如何在自訂動作中運用API呼叫回應的詳細資訊,請參閱 此頁面.

NOTE
回應功能目前在Beta版中提供。

NOTE
裝載範例不可包含Null值。 承載中的欄位名稱不得包含「。」 字元。 開頭不能為「$」字元。

您將能夠定義引數型別(例如:字串、整數等)。

您也可以選擇指定引數是常數還是變數:

  • 常數 表示引數的值是由技術角色在動作設定窗格中定義。 值在歷程中一律相同。 這不會改變,且行銷人員在歷程中使用自訂動作時不會看到。 例如,它可能是協力廠商系統期望的ID。 在這種情況下,切換常數/變數右側的欄位是傳遞的值。
  • 變數 表示引數的值會有所不同。 在歷程中使用此自訂動作的行銷人員可自由傳遞所需值,或指定從何處擷取此引數的值(例如從事件、Adobe Experience Platform等)。 在這種情況下,切換常數/變數右側的欄位是行銷人員將在歷程中看到的標籤,以命名此引數。

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76