[Beta]{class="badge informative"}

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

NOTE
此 Customer.io 來源為測試版。 請閱讀 來源概觀 以取得有關使用測試版標籤來源的詳細資訊。

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

快速入門 getting-started

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

先決條件 prerequisites

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

定義來源結構描述的JSON範例 Customer.io 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"
    }
  }
}

建立Platform結構描述 Customer.io create-platform-schema

您也必須確保建立用於來源的Platform結構。 請參閱上的教學課程 建立平台結構描述 以取得如何建立綱要的完整步驟。

顯示Customer.io結構描述範例的平台UI熒幕擷圖

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

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

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

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

具有Customer.io卡片之目錄的Platform UI熒幕擷圖

選擇資料 select-data

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

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

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

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

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

完成後,選取 下一個.

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

資料流詳細資訊 dataflow-detail

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

完成後,選取 下一個.

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

對應 mapping

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

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

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

目標欄位
說明
object_type
物件型別,請參閱 Customer.io 事件 支援型別的檔案。
id
物件的識別碼。
email
與物件關聯的電子郵件地址。
event_id
事件的唯一識別碼。
cio_id
此 Customer.io 事件的識別碼。
metric
事件型別。 如需詳細資訊,請參閱 Customer.io 事件 支援型別的檔案。
timestamp
事件發生時的時間戳記。
IMPORTANT
不要對應 cio_id 執行時 Customer.io 中的webhook test mode 因為將不會傳送任何相關的欄位 Customer.io.

成功對應來源資料後,請選取 下一個.

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

請檢閱 review

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

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

檢閱資料流後,選取「 」 完成 並留出一些時間建立資料流。

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

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

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

為了建構用於在上設定webhook的URL Customer.io 您必須擷取下列專案:

  • 資料流ID
  • 串流端點

擷取您的 資料流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

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

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

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

顯示webhook端點欄位的Customer.io使用者介面

TIP
您可以訂閱報表webhook的各種不同事件。 發生下列情況時,每個事件的訊息都會擷取至Platform: Customer.io 符合動作事件觸發條件。 如需不同事件的詳細資訊,請參閱 Customer.io 事件檔案.

後續步驟 next-steps

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

其他資源 additional-resources

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

護欄 guardrails

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

驗證 validation

驗證您是否已正確設定來源及 Customer.io 正在內嵌訊息,請遵循下列步驟:

  • 您可以檢查 Customer.io 活動記錄 識別所擷取事件的頁面 Customer.io.

Customer.io UI熒幕擷圖顯示活動記錄

  • 在Platform UI中選取 檢視資料流 在 Customer.io 來源目錄上的卡片功能表。 接下來,選取 預覽資料集 驗證針對您在中選取的事件擷取的資料 Customer.io.

顯示已擷取事件的平台UI熒幕擷圖

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