[Beta]{class="badge informative"}

在UI中建立Merkury Enterprise Identity Resolution來源連線和資料流

NOTE
Merkury Enterprise Identity Resolution來源是測試版。 如需使用Beta版標籤來源的相關資訊,請參閱來源概觀

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

快速入門

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

收集必要的認證

若要在Experience Platform上存取貯體,您必須提供下列憑證的有效值:

認證
說明
存取金鑰
貯體的存取金鑰ID。 您可以從您的Merkury團隊擷取此值。
秘密金鑰
貯體的秘密金鑰ID。 您可以從您的Merkury團隊擷取此值。
貯體名稱
這是您的Merkury貯體,檔案將在此共用。 您可以從您的Merkury團隊擷取此值。

如需設定Merkury和其他必要條件的詳細資訊,請閱讀Merkury 來源概觀

連線您的Merkury帳戶

在Platform UI中,從左側導覽列選取​ 來源 ​以存取來源工作區。 目錄畫面會顯示您可以建立帳戶的各種來源。

您可以從熒幕左側的目錄中選取適當的類別。 或者,您可以使用搜尋選項來尋找您要使用的特定來源。

在​ 資料夥伴 ​類別下,選取​ Merkury,然後選取​ 設定

已選取Merkury來源的來源目錄。

連線至Merkury ​頁面隨即顯示。 您可以在此頁面使用新的證明資料或現有的證明資料。

建立新帳戶

如果您正在使用新認證,請選取​ 新帳戶。 在出現的輸入表單上,提供名稱、選擇性說明和您的Merkury認證。 完成時,請選取​ 連線到來源,然後等待一段時間以建立新連線。

Merkury的新帳戶介面。

使用現有帳戶

若要使用現有帳戶,請選取​ 現有帳戶,然後選取您要使用的Merkury帳戶。 選取​ 下一步 ​以繼續。

Merkury的現有帳戶介面。

recommendation-more-help

支援的檔案格式

您可以使用Merkury來源內嵌下列檔案格式:

  • 分隔符號分隔值(DSV):任何單一字元值都可以當作DSV格式資料檔案的分隔符號。
  • JavaScript Object Notation (JSON): JSON格式的資料檔案必須符合XDM。
  • Apache Parquet: Parquet格式的資料檔案必須符合XDM標準。
  • 壓縮檔: JSON和分隔檔可以壓縮為: bzip2gzipdeflatezipDeflatetarGziptar

新增資料

建立Merkury帳戶後,新增資料 ​步驟就會顯示,提供介面讓您探索Merkury檔案階層,並選取您要帶入Experience Platform的資料夾或特定檔案。

  • 介面的左側是目錄瀏覽器,顯示您的Merkury檔案階層。
  • 介面的右側部分可讓您預覽相容資料夾或檔案中最多100列的資料。

來源工作流程的檔案和資料夾目錄,您可在此選取要擷取的資料。

選取根資料夾以存取資料夾階層。 從這裡,您可以選取單一資料夾,以遞回方式擷取資料夾中的所有檔案。 擷取整個資料夾時,您必須確保該資料夾中的所有檔案都共用相同的資料格式和結構描述。

選取資料夾後,正確的介面會更新為所選資料夾中第一個檔案的內容和結構預覽。

選取要擷取的資料以及檔案預覽介面。

在此步驟中,您可以在繼續之前對資料進行數個設定。 首先,選取​ 資料格式,然後在出現的下拉式面板中為您的檔案選取適當的資料格式。

下表顯示支援的檔案型別適用的資料格式:

檔案類型
資料格式
CSV
已分隔
JSON
JSON
Parquet
XDM Parquet

選取欄分隔符號

選取以檢視如何設定分隔字元的步驟

設定資料格式後,您可以在擷取分隔檔案時設定欄分隔符號。 選取​ 分隔符號 ​選項,然後從下拉式功能表中選取分隔符號。 功能表會顯示分隔字元最常使用的選項,包括逗號(,)、索引標籤(\t)和垂直號(|)。

如果您偏好使用自訂分隔符號,請選取​ 自訂,然後在快顯視窗輸入列中輸入您選擇的單一字元分隔符號。

擷取壓縮檔案

選取以檢視如何擷取壓縮檔案的步驟

您也可以指定其壓縮型別,以內嵌壓縮的JSON或分隔檔案。

在選取資料步驟中,選取要擷取的壓縮檔案,然後選取其適當的檔案型別,以及是否符合XDM規範。 接著,選取​ 壓縮型別,然後為您的來源資料選取適當的壓縮檔案型別。

若要將特定檔案帶入Platform,請選取資料夾,然後選取您要擷取的檔案。 在此步驟中,您也可以使用檔案名稱旁的預覽圖示,來預覽指定資料夾中其他檔案的內容。

完成後,選取​ 下一步

提供資料流詳細資料

資料流詳細資料頁面可讓您選取要使用現有資料集還是新資料集。 在此程式中,您也可以設定要擷取至設定檔的資料,並啟用錯誤診斷、部分擷取和警示等設定。

使用現有的資料集

若要將資料內嵌到現有的資料集中,請選取​ 現有的資料集。 您可以使用進階搜尋選項或捲動下拉式選單中的現有資料集清單,來擷取現有資料集。 選取資料集後,請為資料流提供名稱和說明。

現有的資料集介面。

使用新資料集

若要擷取到新的資料集,請選取​ 新的資料集,然後提供輸出資料集名稱和選用的說明。 接下來,使用進階搜尋選項,或捲動下拉式選單中的現有結構描述清單,選取要對應的結構描述。 選取結構描述後,請為資料流提供名稱和說明。

新資料集介面。

啟用設定檔和錯誤診斷

選取此選項可檢視步驟,以啟用錯誤診斷和設定檔擷取

接著,選取「設定檔資料集」切換功能,啟用您的資料集以建立即時客戶設定檔。 這可讓您建立實體屬性和行為的整體檢視。 來自所有啟用設定檔的資料集的資料將會包含在設定檔中,當您儲存資料流時,將會套用變更。

錯誤診斷可針對資料流中發生的任何錯誤記錄產生詳細的錯誤訊息,而部分擷取可讓您擷取包含錯誤的資料,最多可擷取到您手動定義的特定臨界值。 如需詳細資訊,請參閱部分批次擷取總覽

啟用警示

選取此選項可檢視啟用警示的步驟

您可以啟用警報以接收有關資料流狀態的通知。 從清單中選取警報以訂閱接收有關資料流狀態的通知。 如需警示的詳細資訊,請參閱使用UI訂閱來源警示的指南。

當您完成提供詳細資料給資料流時,請選取​ 下一步

將資料欄位對應至XDM結構描述

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

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

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

對應介面。

排程內嵌執行

排程步驟隨即顯示,允許您設定擷取排程,以使用已設定的對應自動擷取選取的來源資料。 根據預設,排程設定為Once。 若要調整您的擷取頻率,請選取​ 頻率,然後從下拉式選單中選取選項。

TIP
在一次性內嵌期間看不到間隔和回填。

排程介面

如果您將擷取頻率設為MinuteHourDayWeek,則必須設定間隔,以在每次擷取之間建立設定的時間範圍。 例如,擷取頻率設為Day,而間隔設為15,表示您的資料流已排程每15天擷取一次資料。

在此步驟中,您也可以啟用​ 回填,並定義資料增量擷取的資料行。 回填是用來擷取歷史資料,而您為增量擷取定義的欄則可區分新資料與現有資料。

請參閱下表以取得排程設定的詳細資訊。

正在排程設定
說明
頻率

設定頻率以指出資料流執行的頻率。 您可以將頻率設為:

  • 一次:將您的頻率設定為once以建立一次性內嵌。 建立一次性擷取資料流時,無法使用間隔和回填的設定。 依預設,排程頻率會設定為一次。
  • 分鐘:將頻率設為minute,排程您的資料流以每分鐘擷取資料。
  • 小時:將頻率設為hour,排程您的資料流以每小時為基礎擷取資料。
  • :將您的頻率設為day,排程您的資料流每天擷取資料。
  • :將頻率設為week,排程您的資料流每週擷取資料。
間隔

選取頻率後,您就可以設定間隔設定,以建立每次擷取之間的時間範圍。 例如,如果您將頻率設為「天」,並將間隔設為15,則您的資料流將每隔15天執行一次。 您不能將間隔設定為零。 每個頻率的最小接受間隔值如下:

  • 一次:不適用
  • 分鐘: 15
  • 小時: 1
  • : 1
  • : 1
開始時間
預計執行的時間戳記,以UTC時區顯示。
回填
回填會決定最初要擷取的資料。 如果已啟用回填,則會在第一次排程擷取期間擷取指定路徑中的所有目前檔案。 如果停用回填,則只會擷取在第一次內嵌執行到開始時間之間載入的檔案。 將不會擷取在開始時間之前載入的檔案。
NOTE
對於批次擷取,每個後續資料流會根據其​ 上次修改時間 ​時間戳記,選取要從您的來源擷取的檔案。 這表示批次資料流會從來源選取新的或自上次資料流執行以來經過修改的檔案。 此外,您必須確保檔案上傳與排定的資料流執行之間有足夠的時間跨度,因為在排定的資料流執行時間之前未完全上傳到您的雲端儲存體帳戶的檔案可能無法擷取以進行內嵌。

完成擷取排程的設定後,請選取​ 下一步

檢閱您的資料流

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

  • 連線:顯示來源型別、所選來源檔案的相關路徑,以及該來源檔案中的欄數。
  • 指派資料集與對應欄位:顯示要將來源資料擷取到哪個資料集,包括資料集所堅持的結構描述。
  • 排程:顯示內嵌排程的有效期間、頻率和間隔。

檢閱您的資料流後,請按一下[完成] ,並等待一些時間來建立資料流。

檢閱頁面。

後續步驟

依照本教學課程中的指示,您已成功建立資料流,以將批次資料從您的Merkury來源帶入Experience Platform。 如需其他資源,請瀏覽以下概述的檔案。

監視資料流

建立資料流後,您可以監視透過它擷取的資料,以檢視擷取率、成功和錯誤的資訊。 如需如何監視資料流的詳細資訊,請造訪有關UI🔗中監視帳戶和資料流的教學課程。

更新您的資料流

若要更新資料流排程、對應和一般資訊的設定,請瀏覽有關在UI中更新來源資料流的教學課程

刪除您的資料流

您可以刪除不再需要的資料流,或使用​ 資料流 ​工作區中可用的​ 刪除 ​功能建立錯誤的資料流。 如需有關如何刪除資料流的詳細資訊,請瀏覽教學課程,瞭解如何在UI🔗中刪除資料流。

337b99bb-92fb-42ae-b6b7-c7042161d089