[Beta]{class="badge informative"}

在UI中建立Customer.io來源連線和資料流

本教學課程提供使用Adobe Experience Platform使用者介面建立Customer.io來源連線和資料流的步驟。

快速入門 getting-started

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

先決條件 prerequisites

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

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

建立Customer.io來源連線之前，您需要提供來源結構描述。 您可以使用以下JSON。

{
  "event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
  "object_type": "customer",
  "metric": "subscribed",
  "timestamp": 1613063089,
  "data": {
    "customer_id": "42",
    "email_address": "test@example.com",
    "identifiers": {
      "id": "42",
      "email": "test@example.com",
      "cio_id": "d9c106000001"
    }
  }
}

建立Customer.io的平台結構描述 create-platform-schema

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

的範例結構描述

連線您的Customer.io帳戶 connect-account

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

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

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

選取資料 select-data

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

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

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

完成後，選取​ 下一步。

資料流詳細資料 dataflow-detail

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

完成後，選取​ 下一步。

對應 mapping

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

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

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

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

檢閱 review

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

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

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

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

若要建構用來在Customer.io上設定webhook的URL，您必須擷取下列專案：

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

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

在Customer.io中設定報告webhook set-up-webhook

建立webhook URL後，您現在可以使用Customer.io使用者介面設定報告webhook。 如需設定報告Webhook的步驟，請參閱關於設定Webhook的Customer.io 指南。

在Customer.io使用者介面的WEBHOOK ENDPOINT欄位中輸入您的webhook URL。

後續步驟 next-steps

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

其他資源 additional-resources

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

護欄 guardrails

有關護欄的資訊，請參閱Customer.io 逾時和失敗頁面。

驗證 validation

若要驗證您已正確設定來源，而且正在擷取Customer.io則訊息，請遵循下列步驟：