[Beta]{class="badge informative"}

在使用者介面中建立Chatlio來源連線

NOTE
Chatlio來源是測試版。 如需使用Beta版標籤來源的相關資訊,請參閱來源概觀

本教學課程提供使用Adobe Experience Platform使用者介面建立Chatlio來源連線的步驟。

快速入門 getting-started

本教學課程需要您實際瞭解下列Experience Platform元件:

先決條件 prerequisites

下節提供建立Chatlio來源連線之前必須完成的必要條件資訊。

定義Chatlio之來源結構描述的JSON範例 prerequisites-json-schema

建立Chatlio來源連線之前,您需要提供來源結構描述。 您可以使用下方的JSON。

{
  "visitor": {
    "email": "test@example.com",
    "UUID": "2d3f4260-2235-903b-0a82-a23d326cc257"
  },
   "message": "Hi",
  "channelId": "C04J7M7LCMQ",
  "slackChannelName": "aep",
  "slackChannelId": "C04JVR71WKS"
}

建立Chatlio的平台結構描述 create-platform-schema

您也必須確保建立用於來源的Platform結構。 閱讀有關建立Platform結構描述的教學課程,以瞭解如何建立結構描述的完整步驟。

顯示Chatlio範例結構描述的平台UI

連線您的Chatlio帳戶 connect-account

在Platform UI中,從左側導覽選取​ 來源 ​以存取來源工作區,並檢視Experience Platform中可用的來源目錄。

使用​ 類別 ​功能表,依類別篩選來源。 或者,在搜尋列中輸入來源名稱,從目錄中尋找特定來源。

移至行銷自動化類別以檢視Chatlio來源卡。 若要開始,請選取​ 新增資料

含Chatlio卡的Platform UI目錄

選取資料 select-data

選取資料 ​步驟隨即顯示,提供介面供您選取要帶到Platform的資料。

  • 介面的左側是瀏覽器,可讓您檢視帳戶內的可用資料流;
  • 介面的右側部分可讓您預覽JSON檔案中最多100列的資料。

選取​ 上傳檔案 ​以從您的本機系統上傳JSON檔案。 或者,您也可以將要上傳的JSON檔案拖放至拖放檔案面板。

來源工作流程的新增資料步驟。

上傳檔案後,預覽介面會更新,以顯示您上傳的結構描述預覽。 預覽介面可讓您檢查檔案的內容和結構。 您也可以使用搜尋欄位公用程式來存取結構描述中的特定專案。

完成後,選取​ 下一步

來源工作流程的預覽步驟。

資料流詳細資料 dataflow-detail

資料流詳細資料 ​步驟隨即顯示,為您提供使用現有資料集或建立資料流新資料集的選項,以及提供資料流名稱和說明的機會。 在此步驟中,您還可以配置設定檔擷取、錯誤診斷、部分擷取和警報的設定。

完成後,選取​ 下一步

來源工作流程的資料流詳細資料步驟。

對應 mapping

對應步驟出現,為您提供介面,用於將來源結構描述中的來源欄位對應到目標結構描述中適當的目標XDM欄位。

Platform會根據您選取的目標結構或資料集,為自動對應的欄位提供智慧型建議。 您可以手動調整對應規則以符合您的使用案例。 您可以根據自己的需求,選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算或計算的值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱資料準備UI指南

下列對應是強制性的,在繼續進行檢閱階段之前應先進行設定。

目標欄位
說明
UUID
事件的Chatlio識別碼。

成功對應來源資料後,請選取​ 下一步

來源工作流程的對應步驟。

檢閱 review

檢閱 ​步驟隨即顯示,可讓您在建立新資料流之前先檢閱該資料流。 詳細資料會分組到以下類別中:

  • 連線:顯示來源型別、所選來源檔案的相關路徑,以及該來源檔案中的欄數。
  • 指派資料集與對應欄位:顯示要將來源資料擷取到哪個資料集,包括資料集所堅持的結構描述。

檢閱您的資料流後,請選取​ 完成,並等待一些時間來建立資料流。

來源工作流程的稽核步驟。

取得您的串流端點URL get-streaming-endpoint-url

建立串流資料流後,您現在可以擷取串流端點URL。 此端點將用於訂閱您的webhook,允許您的串流來源與Experience Platform通訊。

若要建構用來在Chatlio上設定webhook的URL,您必須擷取下列專案:

  • 資料流ID
  • 串流端點

若要擷取您的​ 資料流ID ​和​ 串流端點,請移至您剛才建立之資料流的資料流活動頁面,並從屬性面板底部複製詳細資料。

資料流活動中的串流端點。

擷取串流端點與資料流ID後,請根據下列模式建置URL: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}。 例如,建構的webhook URL可能如下所示: https://dcs.adobedc.net/collection/d56b47ee3985104beaf724efcd78a3e1a863d720471a482bebac0acc1ab95983

在Chatlio中設定webhook set-up-webhook

建立webhook URL後,您現在可以使用Chatlio使用者介面設定webhook。

登入您的Chatlio帳戶,並遵循安裝與安裝指南來建立Widget。

建立Widget後,請導覽至Widget的設定頁面,將您的webhook URL新增至該Widget。

Chatlio上的webhook設定頁面。

接著,選取「Behavior」標籤,並將您的webhook URL新增至「Webhook when a new conversation starts」欄位以及您要訂閱的任何其他webhook事件欄位。

顯示webhook端點欄位的Chatlio UI。

TIP
您可以為您的Chatlio webhook訂閱各種不同的活動。 如需不同事件的詳細資訊,請參閱Chatlio 事件檔案

後續步驟 next-steps

依照本教學課程中的指示,您已成功設定串流資料流,以將您的Chatlio資料帶入Experience Platform。 若要監視正在擷取的資料,請參閱使用Platform UI監視串流資料流的指南。

其他資源 additional-resources

以下各節提供在使用Chatlio來源時可以參考的其他資源。

驗證 validation

若要驗證您已正確設定來源,而且正在擷取Chatlio則訊息,請遵循下列步驟:

  • 您可以檢查Chatlio 報告 > 聊天記錄 ​頁面,以識別Chatlio擷取的事件。

顯示聊天歷程記錄的Chatlio UI熒幕擷圖

  • 在Platform UI中,選取來源目錄上Chatlio卡片功能表旁的​ 檢視資料流程。 接著,選取​ 預覽資料集 ​以驗證針對您已在Chatlio中設定的Webhook所擷取的資料。

顯示內嵌事件的平台UI熒幕擷取畫面

如需Chatlio的其他資訊,請瀏覽Chatlio 檔案常見問答集

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089