[Beta]{class="badge informative"}

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主題：

建立對象：

開發人員

NOTE

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

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

快速入門 getting-started

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

Experience Data Model (XDM) 系統： Experience Platform用來組織客戶體驗資料的標準化架構。
- 結構描述組合的基本概念：瞭解XDM結構描述的基本建置區塊，包括結構描述組合中的關鍵原則和最佳實務。
- 結構描述編輯器教學課程：瞭解如何使用結構描述編輯器使用者介面建立自訂結構描述。
Real-Time Customer Profile：根據來自多個來源的彙總資料，提供統一的即時消費者設定檔。

先決條件 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