設定自訂動作 configure-an-action
如果您使用協力廠商系統來傳送訊息,或想要歷程傳送API呼叫至協力廠商系統,請使用自訂動作來設定其與您歷程的連線。 例如,您可以使用自訂動作連線到下列系統:Epsilon、Slack、 Adobe Developer、Firebase等
自訂動作是技術使用者定義的其他動作,可供行銷人員使用。 設定後,其會顯示在您歷程的左側浮動視窗中,位於 動作 類別。 在本頁中瞭解更多。
限制 custom-actions-limitations
自訂動作隨附下列幾項限制 此頁面.
在自訂動作引數中,您可以傳遞簡單集合以及物件集合。 進一步瞭解中的集合限制 此頁面.
另請注意,自訂動作引數採用預期格式(例如:字串、小數等)。 您必須注意遵守這些預期的格式。 在本節瞭解更多 使用案例.
最佳作法 custom-action-enhancements-best-practices
使用自訂動作選擇要作為目標的端點時,請確定:
所有自訂動作皆已定義1分鐘上300,000次呼叫的上限。 此外,預設上限會針對每個主機和每個沙箱執行。 例如,在沙箱上,如果您有主機相同的兩個端點 (例如:https://www.adobe.com/endpoint1
和 https://www.adobe.com/endpoint2
),此上限會套用至 adobe.com 主機下的所有端點。 「endpoint1」和「endpoint2」會共用相同的上限設定,而且讓一個端點達到限制會影響到另一個端點。
此限制是根據客戶使用情況來設定,可保護自訂動作鎖定為目標的外部端點。您需要定義適當的讀取率 (使用自訂動作時為每秒 5000 個設定檔),以在對象歷程中將其列入考量。 如有需要,您可以透過上限/節流 API 定義較高的上限或節流限制來覆寫此設定。 請參閱此頁面。
基於以下各種原因,您不應使用自訂動作來鎖定公用端點:
- 如果沒有適當的上限或節流,可能會傳送過多呼叫至可能不支援此磁碟區的公用端點。
- 設定檔資料可透過自訂動作傳送,因此定位公用端點可能會導致無意間在外部共用個人資訊。
- 您無法控制公用端點傳回的資料。 如果端點變更其API或開始傳送不正確的資訊,這些資訊將可在傳送的通訊中使用,並可能產生負面影響。
同意與資料控管 privacy
在Journey Optimizer中,您可以將資料控管和同意原則套用至自訂動作,以防止特定欄位匯出至協力廠商系統,或排除尚未同意接收電子郵件、推播或簡訊通訊的客戶。 如需詳細資訊,請參閱下列頁面:
設定步驟 configuration-steps
以下是設定自訂動作所需的主要步驟:
-
在「管理」功能表區段中,選取 設定. 在 動作 區段,按一下 管理. 按一下 建立動作 以建立新動作。 動作設定窗格會在畫面右側開啟。
-
輸入動作的名稱。
note note NOTE 只允許使用英數字元和底線。 長度上限為30個字元。 -
新增說明至您的動作。 此步驟為選填。
-
使用此動作的歷程次數會顯示在 使用位置 欄位。 您可以按一下 檢視歷程 按鈕來顯示使用此動作的歷程清單。
-
定義不同的 URL設定 引數。 請參閱此頁面。
-
設定 驗證 區段。 此設定與資料來源的設定相同。 另請參閱 本節.
-
定義 動作引數. 請參閱此頁面。
-
按一下 儲存。
自訂動作現已設定完畢,且可供您在歷程中使用。 請參閱此頁面。
note note NOTE 當歷程中使用自訂動作時,大部分引數均為唯讀。 您只能修改 名稱, 說明, URL 欄位和 驗證 區段。
端點設定 url-configuration
設定自訂動作時,您需要定義下列專案 端點設定 引數:
-
在 URL 欄位,指定外部服務的URL:
-
如果URL是靜態的,請在此欄位中輸入URL。
-
如果URL包含動態路徑,請只輸入URL的靜態部分,也就是配置、主機、連線埠,以及(選擇性)路徑的靜態部分。
範例:
https://xxx.yyy.com/somethingstatic/
將自訂動作新增至歷程時,您將指定URL的動態路徑。 了解更多。
note note NOTE 基於安全考量,我們強烈建議您針對URL使用HTTPS配置。 我們不允許使用非公開的Adobe位址和IP位址。 定義自訂動作時只允許預設連線埠:80用於http,443用於https。 -
-
選取通話 方法:它可以 POST, GET 或 PUT.
note note NOTE 此 DELETE 方法不受支援。 如果您需要更新現有資源,請選取 PUT 方法。 -
定義標頭和查詢引數:
- 在 標頭 區段,按一下 新增標題欄位 定義要傳送給外部服務之要求訊息的HTTP標頭。 此 Content-Type 和 字元集 標頭欄位預設為設定。 您無法刪除這些欄位。 僅限 Content-Type 標頭可以修改。 其值應符合JSON格式。 以下是預設值:
- 在 查詢引數 區段,按一下 新增查詢引數欄位 以定義您要新增至URL的引數。
-
輸入欄位的標籤或名稱。
-
選取型別: 常數 或 變數. 如果您已選取 常數,然後輸入中的常數值 值 欄位。 如果您已選取 變數,則您會在將自訂動作新增至歷程時指定此變數。 了解更多。
note note NOTE 將自訂動作新增至歷程後,如果歷程處於草稿狀態,您仍可新增標題或查詢引數欄位至歷程。 如果您不希望歷程受設定變更影響,請複製自訂動作,並將欄位新增到新的自訂動作。 標頭會根據欄位剖析規則進行驗證。 進一步瞭解 本檔案.
mTLS通訊協定支援 mtls-protocol-support
您現在可以使用相互傳輸層安全性(mTLS),確保對Adobe Journey Optimizer自訂動作的輸出連線具有增強的安全性。 mTLS是一種用於相互驗證的端對端安全性方法,可確保共用資訊的雙方在共用資料之前,都是聲稱的身分。 mTLS包括相較於TLS的額外步驟,其中伺服器也會要求使用者端的憑證並在其末端驗證它。
自訂動作支援雙向TLS (mTLS)驗證。 自訂動作或歷程中不需要額外設定即可啟用mTLS;偵測到啟用mTLS的端點時,會自動發生此情況。 了解更多。
定義裝載引數 define-the-message-parameters
-
在 請求 區段,貼上要傳送至外部服務的JSON裝載範例。 此欄位是選用欄位,僅適用於POST和PUT呼叫方法。
-
在 回應 區段,貼上呼叫傳回之裝載的範例。 此欄位是選用欄位,可用於所有呼叫方法。 如需如何在自訂動作中運用API呼叫回應的詳細資訊,請參閱 此頁面.
您將能夠定義引數型別(例如:字串、整數等)。
您也可以選擇指定引數是常數還是變數:
- 常數 表示引數的值是由技術角色在動作設定窗格中定義。 值在歷程中一律相同。 這不會改變,且行銷人員在歷程中使用自訂動作時不會看到。 例如,它可能是協力廠商系統期望的ID。 在這種情況下,切換常數/變數右側的欄位是傳遞的值。
- 變數 表示引數的值會有所不同。 在歷程中使用此自訂動作的行銷人員可自由傳遞所需值,或指定從何處擷取此引數的值(例如從事件、Adobe Experience Platform等)。 在這種情況下,切換常數/變數右側的欄位是行銷人員將在歷程中看到的標籤,以命名此引數。