文件Experience Platform資料準備指南

資料準備UI指南 data-prep-ui-guide

Last update: Thu Nov 20 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 開發人員

閱讀本指南，瞭解如何在Adobe Experience Platform使用者介面中使用資料準備對應函式，將CSV檔案對應至體驗資料模型(XDM)結構描述。

快速入門

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

  • Experience Data Model (XDM) 系統： Experience Platform用來組織客戶體驗資料的標準化架構。

  • 身分識別服務：透過跨裝置和系統橋接身分，以更清楚瞭解個別客戶及其行為。

  • Real-Time Customer Profile：根據來自多個來源的彙總資料，提供統一的即時消費者設定檔。

  • 來源： Experience Platform允許從各種來源擷取資料，同時讓您能夠使用Experience Platform服務來建構、加標籤以及增強傳入的資料。

存取UI中的對應介面

您可以透過兩個不同的路徑存取UI中的對應介面。

  1. 在Experience Platform UI中，從左側導覽選取​Workflows，然後選取​Map CSV to XDM schema。 接下來，提供您的資料流詳細資料，並選取您要擷取的資料。 完成後，您將進入對應介面，您可以在其中設定來源資料和XDM結構描述之間的對應。
  2. 您也可以透過來源工作區存取對應介面。

將CSV檔案對應至XDM結構描述

使用對應介面和它提供的完整工具集，成功將來源結構描述中的資料欄位對應到目標結構描述中適當的目標XDM欄位。

Experience Platform UI中的對應介面。

瞭解對應介面 mapping-interface

如需內嵌工作流程內容中對應欄位健康情況的相關資訊，請參閱介面頂端的儀表板。 控制面板會顯示下列有關對應欄位的詳細資訊：

屬性
說明
Mapped fields
顯示已對應至目標XDM欄位的來源欄位總數（無論是否有錯誤）。
Required fields
顯示必要對應欄位的數量。
Identity fields
顯示定義為身分的對應欄位總數。 這些對應欄位會以指紋圖示表示。
Errors
顯示錯誤對應欄位的數量。

接下來，您可以使用標頭中列出的選項，以便更妥善地透過對應欄位進行互動或篩選。

選項
說明
Search source fields
使用搜尋列導覽至特定來源欄位。
All fields

選取​ All fields ​以檢視篩選對應所依據的下拉式選項功能表。 可用的篩選選項包括：

  • Required fields：篩選介面以僅顯示完成工作流程所需的欄位。
  • Identity fields：篩選介面以僅顯示標籤為身分的欄位。
  • Mapped fields：篩選介面以僅顯示已對應的欄位。
  • Unmapped fields：篩選介面以僅顯示尚未對應的欄位。
  • Fields with errors：篩選介面以僅顯示有錯誤的欄位。
New field type
選取​ New field type ​以新增欄位或計算欄位。 如需詳細資訊，請閱讀新增欄位型別的章節。
Import mappings
選取​ Import mappings ​以從現有的檔案或資料流匯入對應。 如需詳細資訊，請閱讀有關匯入對應的章節。
Validate
選取​ Validate ​以檢查對應中的錯誤。
Download template
選取​ Download template ​以匯出並下載您的對應CSV檔案。
Preview data
選取​ Preview data ​以使用預覽面板，並檢查來源資料集的結構和內容。
Clear all
選取​ Clear all ​以刪除介面中的所有對應。

新增欄位型別 add-a-new-field-type

您可以選取​New field type，以新增對應欄位或計算欄位。

新對應欄位

若要新增對應欄位，請選取​New field type，然後從出現的下拉式功能表中選取​Add new field。

已選取[新增欄位]按鈕的對映介面。

接著，從出現的來源結構描述樹狀結構中，選取您要新增的來源欄位，然後選取​Select。

來源結構描述已選取「國家/地區」作為額外的新欄位。

對應介面會以您選取的來源欄位和空的目標欄位更新。 選取​ Map target field ​以開始將新的來源欄位對應到其適當的目標XDM欄位。

具有新的未對應來源欄位的對應介面。

互動式目標結構描述樹狀目錄隨即顯示，可讓您手動瀏覽目標結構描述，並為您的來源欄位找到適當的目標XDM欄位。

已選取新目標欄位的互動式目標配置樹狀結構。

計算欄位 calculated-fields

計算欄位允許根據輸入結構描述中的屬性建立值。 然後可以將這些值指派給目標架構中的屬性，並提供名稱和說明以便更輕鬆地參考。 計算欄位的長度上限為4096個字元。

若要建立計算欄位，請選取​New field type，然後選取​Add calculated field

已選取[新增計算欄位]按鈕的對映介面。

Create calculated field​視窗會出現。 使用介面輸入計算欄位，並參閱左側的對話方塊，瞭解支援的欄位、函式和運運算元。

標記
說明
Function
函式標籤會列出可用來轉換資料的函式。 若要深入瞭解您可以在計算欄位中使用的函式，請參閱使用資料準備（對應程式）函式的指南。
Field
欄位索引標籤會列出來源結構描述中可用的欄位和屬性。
Operator
運運算元索引標籤會列出可用於轉換資料的運運算元。

計算欄位介面

您可以使用中央的運算式編輯器，手動新增欄位、函式和運運算元。 選取編輯器以開始建立運算式。 完成後，請選取「Save」以繼續。

匯入對應 import-mapping

您可以使用資料準備的匯入對應功能，減少資料擷取程式的手動設定時間，並限制錯誤。 您可以從現有流程或匯出的檔案匯入對應。

從流程匯入對應

如果您有多個資料流是根據類似的來源檔案和目標結構描述，那麼您可以匯入現有的對應，並將其重複用於新的資料流。

若要從現有的資料流匯入對應，請選取​Import mappings，然後選取​Import mapping from flow。

已選取具有「匯入對應」和「從流程匯入對應」的對應介面。

接下來，使用快顯視窗來尋找您要匯入其對應的資料流。 在此步驟中，您也可以使用搜尋功能來隔離特定資料流並擷取其對應。 完成後，選取​Select。

可以匯入對應對應的現有資料流清單。

從檔案匯入對應

在某些情況下，您可能需要為資料實作大量對應。 您可以使用對應介面手動執行此操作，但也可以匯出對應範本並在離線試算表上設定對應，以節省時間並避免Experience Platform上的使用者逾時。

若要從匯出的檔案匯入對應，請選取​Import mappings，然後選取​Import mapping from file。

已選取「匯入對應」和「從檔案匯入對應」的對應介面。

接下來，使用Upload template視窗下載對映的CSV復本。 然後，您可以使用任何支援編輯CSV檔案型別的軟體，在本機裝置上設定對應。 在此步驟中，您必須確保僅使用來源檔案和目標結構描述中提供的欄位。

此上載範本視窗會顯示下載和上載轉存的對應csv檔案的選項。

accordion
選取以檢視匯出的對應檔案的範例
對應範本的已下載csv檔案。

完成後，請選取​ Upload file ​並選取您對應的更新csv檔案。 請稍候系統處理，然後選取​Done。

上載範本視窗已上載新檔案。

完成對應後，您現在可以選取​ Finish ​並繼續下一步以完成資料流。

TIP
完成建立對應後，請等候最多10分鐘再開始資料擷取。 此等待期可確保您的新對應完全儲存並可在系統中使用。

具有完整對應集的對應介面。

後續步驟

您現在可以使用Experience Platform UI中的對應介面，成功將CSV檔案對應至目標XDM結構描述。 如需詳細資訊，請閱讀下列檔案：

recommendation-more-help
461cc884-c234-4a0c-ac75-6efbaafc1394