Beta

建立 Pendo 來源連線資料流和UI中

上次更新: 2023-09-01
  • 主題:
  • Sources
    檢視有關此主題的更多資訊
  • 建立對象:
  • Developer
    User
    Admin
    Leader
注意

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

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

快速入門

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

先決條件

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

定義來源結構描述的JSON範例 Pendo

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

{
  "accountId": "58f79ee324d3f",
  "timestamp": 1673372516,
  "visitorId": "test@test.com",
  "uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
  "properties": {
    "guideProperties": {
  "name": "Guide Conversion Test"
  }
}
}

如需詳細資訊,請閱讀 Pendo webhook指南.

建立Platform結構描述 Pendo

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

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

連線您的 Pendo 帳戶

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

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

前往 Analytics 類別以檢視 Pendo 來源卡。 若要開始,請選取 新增資料.

具有Pendo卡的Platform UI來源目錄。

選擇資料

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

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

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

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

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

完成後,選取 下一個.

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

資料流詳細資訊

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

完成後,選取 下一個.

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

對應

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

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

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

目標欄位 說明
uniqueId 此 Pendo 事件的識別碼。

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

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

請檢閱

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

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

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

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

取得您的串流端點URL

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

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

  • 資料流ID
  • 串流端點

擷取您的 資料流ID串流端點,前往 資料流活動 的資料流頁面,並從 屬性 面板。

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

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

在中設定Webhook Pendo

接下來,登入您的帳戶於 Pendo 並建立webhook。 有關如何使用 Pendo 使用者介面,請參閱 Pendo 建立webhook指南.

建立webhook後,請導覽至 Pendo webhook ,並在 URL 欄位。

顯示webhook端點欄位的Pendo UI熒幕擷圖

秘訣

您可以訂閱各種不同的事件類別,以決定您要從傳送的事件型別 Pendo 執行個體重新命名為Platform。 如需不同事件的詳細資訊,請參閱 Pendo 檔案.

後續步驟

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

其他資源

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

驗證

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

  • 您可以檢查 Pendo 報表 > 聊天記錄 識別所擷取事件的頁面 Pendo.

Pendo UI熒幕擷圖顯示聊天記錄

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

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

錯誤與疑難排解

檢查資料流執行時,您可能會遇到下列錯誤訊息: The message can't be validated ... uniqueID:expected minLength:1, actual 0].

平台UI熒幕擷圖顯示錯誤。

若要修正此錯誤,您必須確認 唯一識別碼 已設定對應。 如需其他指引,請參閱 Mping 區段。

如需詳細資訊,請造訪 Pendo 說明中心.

本頁內容