文件Experience Platform來源連接器指南

[Beta]{class="badge informative"}

使用UI將批次資料從Talon.One擷取到Experience Platform

Last update: Mon Apr 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 開發人員
AVAILABILITY
Talon.One來源是測試版。 閱讀來源概觀中的條款與條件，以取得有關使用測試版標籤之來源的詳細資訊。

批次資料的Talon.One來源會接收為Talon.One應用程式記錄的事件。 常見的使用案例是篩選talon_session_closed以接收完成的交易，包括獲得或兌換的忠誠度積分、兌換的優惠券、授予的折扣等。 閱讀Talon.One 管理API參考，瞭解有關API的詳細資訊。

按照本教學課程瞭解如何使用UI中的來源工作區將批次資料從您的Talon.One帳戶擷取到Adobe Experience Platform。

快速入門

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

IMPORTANT
閱讀Talon.One 總覽，瞭解將帳戶連線至Experience Platform之前需要完成的先決條件步驟。

瀏覽來源目錄

在Experience Platform UI中，從左側導覽選取「Sources」以存取​ Sources ​工作區。 在​ Categories ​面板中選取適當的類別。 或者，使用搜尋列導覽至您要使用的特定來源。

若要從Talon.One擷取資料，請在​ Talon.One Batch Source Connector ​下選取​ Loyalty ​來源卡，然後選取​Add data。

TIP
當指定的來源尚未具有已驗證的帳戶時，來源目錄中的來源會顯示​ Set up ​選項。 建立已驗證的帳戶後，此選項會變更為​Add data。

已選取Talon.One批次來源聯結器卡的來源目錄。

建立新帳戶

TIP
建立新帳戶之前，請檢閱概觀中的必要條件Talon.One，以瞭解需要哪些驗證認證。

若要為您的Talon.One來源建立新帳戶，請選取​New account，並為您的帳戶提供名稱和選擇性說明。 接下來，提供您的Talon.One網域和您的Talon.One Management API Key。 完成後，請選取「Connect to source」，讓您的連線建立一段時間。

來源工作流程的建立新帳戶步驟。

使用現有帳戶

若要使用現有帳戶，請選取​Existing account，然後從帳戶介面選取您要使用的Talon.One帳戶。

選取資料

驗證之後，請提供您​ applicationId ​和​ sessionType ​的值。 在此步驟中，您可以使用預覽功能來檢查資料的結構。 完成後，選取​ Next ​以繼續。

TIP
若要擷取已完成的交易（包括已贏取或兌換的熟客點數、兌換的抵用券以及授予的折扣），請選取talon_session_closed事件型別。 如需依型別篩選事件的詳細資訊，請參閱API檔案 Talon.One 中的"type"查詢引數。

來源工作流程的選取資料和預覽步驟。

設定資料集和資料流詳細資料

接下來，您必須提供有關資料集和資料流的資訊。

資料集詳細資料

資料集是資料集合的儲存和管理結構，通常是包含方案（欄/欄位）和記錄（列）的表格。 成功內嵌至Experience Platform的資料會以資料集的形式保留在資料湖中。

在此步驟中，您可以使用現有的資料集或建立新的資料集。

NOTE
無論您是使用現有資料集還是建立新資料集，都必須確保您的資料集已啟用設定檔​內嵌。
選取以啟用設定檔擷取、錯誤診斷及部分擷取的步驟。

如果您的資料集已啟用即時客戶個人檔案，那麼在此步驟中，您可以切換​ Profile dataset ​以啟用您的資料以進行個人檔案擷取。 您也可以使用此步驟來啟用​ Error diagnostics ​和​Partial ingestion。

  • Error diagnostics：選取​ Error diagnostics ​以指示來源產生錯誤診斷，以便您稍後在監視資料集活動和資料流狀態時參考。
  • Partial ingestion：部分批次擷取是擷取包含錯誤的資料的能力，最多可達特定可設定的臨界值。 此功能可讓您將所有精確資料成功擷取到Experience Platform，同時所有不正確的資料會個別批次處理，並提供無效原因的資訊。

資料流詳細資料

設定資料集後，您必須提供資料流的詳細資訊，包括名稱、選用的說明和警報設定。

資料流詳細資料介面。

資料流設定
說明
資料流名稱
資料流的名稱。 依預設，這將使用正在匯入的檔案名稱。
說明
（選用）資料流的簡短說明。
警報

Experience Platform可產生使用者可訂閱的事件型警報，這些選項可讓執行中的資料流觸發這些警報。 如需詳細資訊，請閱讀警示概述

  • 來源資料流執行開始：選取此警示以在您的資料流執行開始時收到通知。
  • 來源資料流執行成功：選取此警示以在您的資料流結束且沒有任何錯誤時接收通知。
  • 來源資料流執行失敗：選取此警示以在您的資料流執行結束時發生任何錯誤時接收通知。

對應

在設定資料集和資料流詳細資料後，您現在可以繼續將來源資料欄位對應到其適當的目標XDM欄位。 在將資料擷取至Experience Platform之前，請使用對應介面將來源資料對應至適當的結構描述欄位。 如需詳細資訊，請閱讀UI中的對應指南。

IMPORTANT
如需對應您Talon.One來源資料的其他指引，請閱讀Talon.One 概觀。

來源工作流程的對應介面。

排程您的資料流擷取

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

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

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

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

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

正在排程設定
說明
頻率

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

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

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

  • 一次：不適用
  • 分鐘： 15
  • 小時： 1
  • 天： 1
  • 周： 1
開始時間
預計執行的時間戳記，以UTC時區顯示。
回填
回填會決定最初要擷取的資料。 如果已啟用回填，則會在第一次排程擷取期間擷取指定路徑中的所有目前檔案。 如果停用回填，則只會擷取在第一次內嵌執行到開始時間之間載入的檔案。 將不會擷取在開始時間之前載入的檔案。

來源工作流程的排程設定步驟。

檢閱

Review​步驟隨即顯示，可讓您在建立資料流之前先檢閱其詳細資訊。 詳細資料會分組到以下類別中：

  • Connection：顯示帳戶名稱、來源平台和來源名稱。
  • Assign dataset and map fields：顯示目標資料集以及資料集所遵守的結構描述。

確認詳細資料正確之後，請選取​Finish。

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

監視資料流

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

已知限制

將資料從Talon.One的結構描述對應到Adobe Experience Platform時，目前無法在單一交易中擷取相同型別的多個效果。 例如，如果交易包含多個setDiscount效果（例如不同行銷活動的折扣），則對應期間只會保留其中一個效果，而其他效果則會被覆寫。

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