[有限可用性]{class="badge informative"}

設定自訂管道 create-custom-channel

在此頁面上:​瞭解如何使用頻道產生器,透過定義端點URL、標頭、驗證、節流原則及訊息裝載結構,在Adobe Journey Optimizer中建立自訂頻道。

若要在行銷活動和歷程中使用自訂頻道,管理員必須先建立頻道。 這涉及定義端點、驗證、節流原則和訊息裝載結構。

頻道產生器​區段是定義新自訂頻道的中央介面。 它可讓您建立及設定自訂通道,也可管理API認證,以及委派子網域。

IMPORTANT
若要存取Channel Builder、建立和管理自訂頻道,您必須授予​ 檢視自訂頻道 ​和​ 管理自訂頻道 ​許可權。本節中瞭解如何管理許可權。

存取及管理自訂頻道 access-channel-builder

若要存取​ 頻道產生器 ​並管理您的自訂頻道,請遵循下列步驟。

  1. 前往左側導覽邊欄中的​管理 > 管道

  2. 選取​ 頻道產生器 ​區段下的​自訂頻道

    自訂管道清查 {width="100%"}

  3. 詳細目錄會列出您沙箱中的所有自訂管道,包括其目前狀態以及用於連線至外部端點的驗證型別。

  4. 您可以依狀態(草稿作用中​或​已封存) (建立者)來篩選自訂頻道,並按名稱搜尋。

  5. 若要編輯管道,請在詳細目錄中按一下管道名稱、進行變更並儲存。 對於使用中頻道,您只能編輯某些欄位 — 瞭解更多

    note caution
    CAUTION
    修改作用中頻道的節流或重試設定,會立即對所有執行中和未來的執行生效。
  6. 若要封存管道,請從詳細目錄開啟它,然後按一下​封存

    封存使用中頻道會將它從所有選取專案下拉式清單(行銷活動動作選擇器、歷程動作浮動視窗、頻道設定和內容範本)中移除。 已使用此管道的現有歷程和行銷活動可繼續正常運作。

建立自訂頻道 create-channel

若要建立新的自訂管道,請遵循下列步驟。

  1. 按一下​ 建立自訂頻道 ​按鈕,開啟頻道建立表單。 首先定義自訂管道的一般設定。

    一般設定 {width="70%"}

  2. 在​ 屬性 ​區段中,為您的自訂頻道輸入​名稱。 此名稱會出現在歷程畫布和行銷活動動作選擇器中。

    note
    NOTE
    名稱必須是唯一的、以字母(A-Z)開頭、僅包含英數字元或特殊字元( _、.、-),並且應大於1個字元。
  3. 您可以從預設圖示資料庫中選取圖示,或從電腦中選取SVG檔案。

    note
    NOTE
    檔案不得大於150KB。

    此圖示將顯示在歷程畫布中的頻道名稱旁。 如果未上傳任何圖示,則會使用預設的圖示。

  4. 輸入選用的​描述

設定端點設定 endpoint-configuration

您必須設定端點,這是外部傳訊系統的HTTP URL。 當設定檔符合促銷活動或歷程的資格時,Journey Optimizer會使用個人化裝載將POST要求傳送至此端點。

端點組態 {width="80%"}

  1. 在​ 端點組態 ​區段中,輸入外部傳訊系統的主機​URL。 例如: https://api.my-messaging-provider.com/v1/messages

    note important
    IMPORTANT
    您的外部傳訊系統必須公開Journey Optimizer可以透過HTTP POST呼叫的HTTPS端點。 端點必須:
    • 接受您的管道所定義的裝載格式(JSON)。
    • 支援Channel Builder中可用的其中一種驗證方法。 了解更多
    • 傳回HTTP 2xx回應以確認成功收到請求。
  2. 視需要新增​標頭。 標頭是在HTTP要求層級傳輸的機碼值組。 它們會與每個要求一併傳送至您的端點,通常用於驗證權杖、內容型別規格或外部系統所需的任何其他中繼資料。

    標頭設定 {width="60%"}

    對於每個標頭,您可以定義其值是否為:

    • Constant — 每個要求中設定一次且包含的靜態值。 例如,您可以定義值為application/jsonContent-Type引數或值為UTF-8Charset引數。
    • 變數 — 如果在此輸入預設值,除非在管道設定中覆寫,否則會使用此值。 例如,您可以為在執行階段解析的使用者ID定義變數。 深入瞭解
  3. 可選擇使用相同的常數/變數模式,新增​查詢引數。 查詢引數會在傳送時附加至端點URL。 常數引數一律會新增相同的值;變數引數會在傳送時解析,例如從設定檔傳遞使用者識別碼。

    查詢引數 {width="60%"}

  4. 在​ 原則組態 ​區段中,定義Journey Optimizer如何處理要求輸送量和失敗。 這對於確保您的外部系統能夠處理大量請求並避免超出需求非常重要。

    原則組態 {width="70%"}

    • 啟用節流 — 預設為停用。 設定每秒要求數上限(預設值: 5,000c)。 一旦達到限制,請求就會排入佇列,並儘快傳送。
    • 啟用重試 — 預設為啟用。 設定失敗要求的重試次數上限(預設值: 3,可設定的範圍: 0-10)。 這有助於避免在暫時性失敗期間讓端點不知所措。
    • 逾時 — 預設值: 5,000毫秒。設定在認為要求失敗之前等待端點回應的時間上限。

驗證設定 authentication-settings

選取您需要用於此通道的​驗證型別。 可用的選項取決於外部傳訊系統支援的驗證方法。

驗證型別 {width="85%"}

提供端點所需的驗證詳細資料。

  • — 要求傳送時不含認證。
  • API金鑰 — 提供金鑰名稱、值和位置(查詢引數或標頭)。
  • 基本驗證 — 提供使用者名稱和密碼。
  • OAuth 2.0 — 設定OAuth 2.0驗證的裝載。

當驗證型別不是​ None ​時,Journey Optimizer會在啟用時自動產生此管道的初始API認證集。 您可以變更這些認證,並在API認證詳細目錄中建立新的認證。 深入瞭解

不過,在啟用通道之前,必須在此提供驗證詳細資訊,以測試與端點的連線。 可以使用​ 測試連線 ​按鈕來驗證驗證設定。 了解更多

承載設定 payload-configuration

當設定檔符合行銷活動或歷程中的資格時,會將裝載傳送至端點。

在裝載設定中,定義訊息裝載的結構,以及行銷人員可以編寫和個人化的欄位。

  1. 按一下​定義承載,然後選擇如何定義承載:

    • 貼上範例JSON裝載 — 貼上代表性的JSON物件,然後Journey Optimizer自動推斷出其中的結構描述。 例如:

      code language-json
      {
        "channelId": "KakaoTalk08",
        "title": "Flash Sale: 48 Hours Only",
        "body": "New arrivals just dropped. Shop now before they're gone!",
        "image": "https://demo-system-next.s3.amazonaws.com/assets/luma/luma-flash-sale-banner.jpg"
      }
      
    • 匯入JSON結構描述 (即將推出) — 上傳完整的JSON結構描述檔案。

      note availability
      AVAILABILITY
      此功能尚未提供。 這將在未來版本中新增。
  2. 產生結構描述後,Journey Optimizer會在表單檢視中顯示所有偵測到的欄位。

    承載設定 {width="80%"}

  3. 針對每個欄位,設定下列設定:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    設定 說明
    預設值 選填。 若在編寫時未提供個人化值,則使用。
    類型 唯讀,衍生自裝載。 支援的型別: stringintegerdecimalbooleandateTimedateTimeOnlydateOnlylistObjectlistStringlistIntegerlistDecimallistBooleanlistDateTimelistDateTimeOnlylistDateOnly
    必要 如果啟用,則行銷活動或歷程中使用管道時,欄位必須具有值。 缺少必要欄位會觸發驗證錯誤,導致無法啟用。
    頻道設定 如果啟用,欄位會出現在管道設定中,可讓管理員為每個設定設定設定不同的值(例如,每個品牌或區域不同的傳送者ID)。 了解做法

    巢狀欄位使用點標籤法表示(例如,image.id)。

測試並啟動 test-activate

當通道處於​ 草稿 ​狀態時,請使用熒幕上方的​ 測試連線 ​按鈕,將測試要求傳送至您的端點,並驗證端對端連線。

測試連線按鈕 {width="70%"}

檢查外部系統的記錄,確認已收到具有預期驗證和承載的請求。

測試成功後,即可儲存或啟用通道。

  • 按一下​ 另存為草稿 ​以儲存您的進度,而不讓頻道可用。
  • 按一下「啟用」,讓頻道可用於頻道設定、行銷活動和歷程。
IMPORTANT
啟用管道後,只有下列欄位可編輯:名稱、說明、圖示、節流以及重試設定。 端點URL、標頭、查詢引數、驗證和裝載結構已鎖定。

後續步驟 next-steps

您的自訂管道現已建立。 請依照下列剩餘步驟完成設定:

recommendation-more-help
journey-optimizer-help