[Beta]{class="badge informative"}
在UI中建立Pendo來源連線資料流和
本教學課程提供使用Adobe Experience Platform使用者介面建立Pendo來源連線和資料流的步驟。
快速入門 getting-started
本教學課程需要您實際瞭解下列Experience Platform元件:
-
Experience Data Model (XDM) 系統: Experience Platform用來組織客戶體驗資料的標準化架構。
- 結構描述組合的基本概念:瞭解XDM結構描述的基本建置區塊,包括結構描述組合中的關鍵原則和最佳實務。
- 結構描述編輯器教學課程:瞭解如何使用結構描述編輯器使用者介面建立自訂結構描述。
-
Real-Time Customer Profile:根據來自多個來源的彙總資料,提供統一的即時消費者設定檔。
先決條件 prerequisites
下節提供建立Pendo來源連線之前必須完成的必要條件資訊。
定義Pendo之來源結構描述的JSON範例 prerequisites-json-schema
建立Pendo來源連線之前,您需要提供來源結構描述。 您可以使用下方的JSON。
{
"accountId": "58f79ee324d3f",
"timestamp": 1673372516,
"visitorId": "test@test.com",
"uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
"properties": {
"guideProperties": {
"name": "Guide Conversion Test"
}
}
}
如需詳細資訊,請閱讀webhooks🔗的Pendo 指南。
建立Pendo的平台結構描述 create-platform-schema
您也必須確保先建立用於來源的Platform結構描述。 請參閱有關建立Platform結構描述的教學課程,以瞭解如何建立結構描述的完整步驟。
連線您的Pendo帳戶 connect-account
在Platform UI中,從左側導覽選取 來源 以存取來源工作區,並檢視Experience Platform中可用的來源目錄。
使用 類別 功能表,依類別篩選來源。 或者,在搜尋列中輸入來源名稱,從目錄中尋找特定來源。
移至Analytics類別以檢視Pendo來源卡。 若要開始,請選取 新增資料。
選取資料 select-data
選取資料 步驟隨即顯示,提供介面供您選取要帶到Platform的資料。
- 介面的左側是瀏覽器,可讓您檢視帳戶內的可用資料流;
- 介面的右側部分可讓您預覽JSON檔案中最多100列的資料。
選取 上傳檔案 以從您的本機系統上傳JSON檔案。 或者,您也可以將要上傳的JSON檔案拖放至拖放檔案面板。
上傳檔案後,預覽介面會更新,以顯示您上傳的結構描述預覽。 預覽介面可讓您檢查檔案的內容和結構。 您也可以使用搜尋欄位公用程式來存取結構描述中的特定專案。
完成後,選取 下一步。
資料流詳細資料 dataflow-detail
資料流詳細資料 步驟隨即顯示,為您提供使用現有資料集或建立資料流新資料集的選項,以及提供資料流名稱和說明的機會。 在此步驟中,您還可以配置設定檔擷取、錯誤診斷、部分擷取和警報的設定。
完成後,選取 下一步。
對應 mapping
對應步驟出現,為您提供介面,用於將來源結構描述中的來源欄位對應到目標結構描述中適當的目標XDM欄位。
Platform會根據您選取的目標結構或資料集,為自動對應的欄位提供智慧型建議。 您可以手動調整對應規則以符合您的使用案例。 您可以根據自己的需求,選擇直接對應欄位,或使用資料準備函式來轉換來源資料,以衍生計算或計算的值。 如需使用對應程式介面和計算欄位的完整步驟,請參閱資料準備UI指南。
下列對應是強制性的,在繼續進行檢閱階段之前應先進行設定。
uniqueId
成功對應來源資料後,請選取 下一步。
檢閱 review
檢閱 步驟隨即顯示,可讓您在建立新資料流之前先檢閱該資料流。 詳細資料會分組到以下類別中:
- 連線:顯示來源型別、所選來源檔案的相關路徑,以及該來源檔案中的欄數。
- 指派資料集與對應欄位:顯示要將來源資料擷取到哪個資料集,包括資料集所堅持的結構描述。
檢閱您的資料流後,請選取 完成,並等待一些時間來建立資料流。
取得您的串流端點URL get-streaming-endpoint-url
建立串流資料流後,您現在可以擷取串流端點URL。 此端點將用於訂閱您的webhook,允許您的串流來源與Experience Platform通訊。
若要建構用來在Pendo上設定webhook的URL,您必須擷取下列專案:
- 資料流ID
- 串流端點
若要擷取您的 資料流ID 和 串流端點,請移至您剛才建立之資料流的資料流活動頁面,並從屬性面板底部複製詳細資料。
擷取串流端點與資料流ID後,請根據下列模式建置URL: {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}
。 例如,建構的webhook URL可能如下所示: https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95
在Pendo中設定Webhook set-up-webhook
接著,在Pendo登入您的帳戶並建立webhook。 如需有關如何使用Pendo使用者介面建立webhook的步驟,請參閱建立webhook🔗的Pendo 指南。
建立webhook後,請瀏覽至Pendo webhook的設定頁面,並在URL欄位中輸入您的webhook URL。
後續步驟 next-steps
依照本教學課程中的指示,您已成功設定串流資料流,以將您的Pendo資料帶入Experience Platform。 若要監視正在擷取的資料,請參閱使用Platform UI監視串流資料流的指南。
其他資源 additional-resources
以下各節提供在使用Pendo來源時可以參考的其他資源。
驗證 validation
若要驗證您已正確設定來源,而且正在擷取Pendo則訊息,請遵循下列步驟:
- 您可以檢查Pendo 報告 > 聊天記錄 頁面,以識別Pendo擷取的事件。
- 在Platform UI中,選取來源目錄上Pendo卡片功能表旁的 檢視資料流程。 接著,選取 預覽資料集 以驗證針對您已在Pendo中設定的Webhook所擷取的資料。
錯誤與疑難排解 errors-and-troubleshooting
檢查資料流執行時,您可能會遇到下列錯誤訊息: The message can't be validated ... uniqueID:expected minLength:1, actual 0].
若要修正此錯誤,您必須確認已設定 uniqueID 對應。 如需其他指引,請參閱Mmping區段。
如需詳細資訊,請造訪Pendo 說明中心。