文档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以接收已完成的交易，包括已获得或已兑现的忠诚度积分、已兑现的优惠券、已授予的折扣等。 有关API的更多信息，请阅读Talon.One 管理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