設定自訂動作 configure-a-custom-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

設定自訂動作時,您必須定義下列​ 端點設定 ​引數:

{width="70%"}

  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. 選取呼叫​ 方法:它可以是​ POSTGET ​或​ PUT

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

    • 在​ 標頭 ​區段中,按一下​ 新增標頭欄位 ​以定義要傳送給外部服務的要求訊息的HTTP標頭。 預設會設定​ Content-Type ​和​ Charset ​標頭欄位。 您無法刪除這些欄位。 只有​ 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. 在​ Request ​區段中,貼上要傳送至外部服務的JSON裝載範例。 此欄位是選用欄位,僅適用於POST和PUT呼叫方法。

    啟用​ 允許NULL值 ​選項,以便在外部呼叫中保留Null值。 請注意,傳送int、字串等陣列。 不完全支援內有Null值的功能。 例如,即使已核取此選項,下列整數陣列[1, null, 2, 3]也會以[1, 2, 3]傳送。 除此之外,如果這類陣列為Null,則會以空白陣列傳送。

    {width="70%"}

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

NOTE
承載中的欄位名稱不能包含點.字元,也不能以$字元開頭。

在欄位設定中,您必須:

  • 選取引數型別,例如:字串、整數等。

  • 定義常數或變數引數:

    • 常數 ​表示引數值是由技術角色在動作設定窗格中定義。 值在歷程中一律相同。 這不會改變,且行銷人員在歷程中使用自訂動作時看不到。 例如,它可能是協力廠商系統期望的ID。 在這種情況下,常數值會設定為切換常數/變數右側的欄位。

    • 變數 ​表示引數的值可以不同。 在歷程中使用此自訂動作的行銷人員可自由傳遞所需值,或指定從何處擷取此引數的值(例如從事件、Adobe Experience Platform等)。 在這種情況下,切換常數/變數右側的欄位是行銷人員將在歷程中看到的標籤,以命名此引數。

    若為選用引數,請啟用行尾的​ 是選用的 ​選項。 核取此選項後,您就會將引數標示為非強制引數,並讓歷程參與者在歷程中編寫該自訂動作時,選擇是否填入引數。

NOTE
如果您在允許Null值時設定選用引數,則歷程從業人員未填入的引數會傳送為Null。
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76