使用UI创建流连接

本教程提供了使用Sources工作区创建流源连接的步骤。

快速入门

本教程需要对Adobe Experience Platform的以下组件有一定的了解:

创建流连接

在平台UI中,从左侧导航中选择​Sources​以访问Sources工作区。 Catalog屏幕显示了您可以使用创建帐户的各种源。

您可以从屏幕左侧的目录中选择相应的类别。 或者,您可以使用搜索选项找到要处理的特定源。

在​​类别下,选择​HTTP API,然后选择​添加数据

目录

出现​连接HTTP API帐户​页面。 在此页面上,您可以使用新凭据或现有凭据。

现有帐户

要使用现有帐户,请选择要使用创建新数据流的HTTP API帐户,然后选择​Next​以继续。

现有帐户

新帐户

如果要创建新帐户,请选择​新建帐户。 在显示的输入窗体上,提供帐户名称和可选描述。 您还可以选择提供以下配置属性:

  • 身份验证: 此属性确定流连接是否需要身份验证。身份验证可确保从可信来源收集数据。 如果您要处理个人身份信息(PII),则应该打开此资产。 默认情况下,此属性处于关闭状态。
  • XDM兼容: 此属性指示此流连接是否将发送与XDM架构兼容的事件。默认情况下,此属性处于关闭状态。

完成后,选择​连接到源,然后选择​下一步​以继续。

新帐户

选择数据

创建HTTP API连接后,将显示​选择数据​步骤,为您提供一个用于上传和预览数据的接口。

选择​上传文件​以上传数据。 或者,也可以将数据拖放到界面的拖放文件部分。

添加数据

上传数据后,您可以使用界面的右侧预览文件层次结构。 选择​下一步​以继续。

preview-sample-data

将数据字段映射到XDM架构

将显示映射步骤,提供一个接口,用于将源数据映射到Platform数据集。

Parquet文件必须符合XDM标准,并且不需要您手动配置映射,而CSV文件要求您明确配置映射,但允许您选择要映射的源数据字段。 如果JSON文件标记为XDM投诉,则无需手动配置。 但是,如果它未标记为符合XDM,则需要您明确配置映射。

为要摄取到的入站数据选择数据集。 您可以使用现有数据集,也可以创建新数据集。

创建新数据集

要创建新数据集,请选择​New dataset。 在显示的表单中,提供名称、可选描述以及数据集的目标架构。 如果选择启用了Profile的架构,则可以选择数据集是否也应启用Profile。

新数据集

使用现有数据集

要使用现有数据集,请选择​现有数据集。 在显示的表单中,选择要使用的数据集。 选择数据集后,您可以选择是否应启用该数据集Profile。

现有数据集

映射标准字段

根据您的需要,您可以选择直接映射字段,或使用数据准备函数转换源数据以导出计算值或计算值。 有关映射器函数和计算字段的详细信息,请参阅数据准备函数指南计算字段指南

要添加新源字段,请选择​添加新映射

add-new-mapping

出现新的源字段和目标字段配对。 要添加新的源字段,请选择选择源字段输入栏旁边的箭头图标。

select-source-field

通过选择属性面板,您可以浏览文件层次结构并选择要映射到目标XDM字段的特定源字段。 选择要映射的源字段后,选择​选择​以继续。

select-attributes

现在,选择源字段后,您可以识别要映射到的相应目标XDM字段。 选择目标字段部分下的架构图标。

select-target-field

此时会出现将源字段映射到目标字段窗口,为您提供一个界面来浏览目标数据集的架构。 选择与源字段匹配的目标字段,然后选择​选择​以继续。

映射到目标字段

在所有源字段都映射到相应的目标XDM字段后,选择​Next

data-prep-complete

数据流详细信息

出现​数据流详细信息​步骤。 在本页中,您可以通过提供名称和可选描述来提供已创建数据流的详细信息。

在提供数据流的详细信息后,选择​下一步

数据流详细信息

审阅

此时将显示​查看​步骤,允许您在创建数据流之前查看数据流的详细信息。 详细信息属于以下类别:

  • 连接:显示帐户名称、源平台和源名称。
  • 分配数据集和映射字段:显示目标数据集以及数据集所遵循的架构。

确认详细信息正确后,选择​完成

审查

获取流端点URL

创建连接后,将显示源详细信息页面。 本页显示新创建连接的详细信息,包括以前运行的数据流、ID和流端点URL。

端点

后续步骤

在本教程后,您创建了一个流HTTP连接,使您能够使用流端点访问各种Data Ingestion API。 有关在API中创建流连接的说明,请阅读创建流连接教程

要了解如何将数据流式传输到Platform,请阅读流时间系列数据的教程或流记录数据的教程。

在此页面上