创建 HTTP API 使用UI流式连接

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

快速入门

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

• Experience Data Model (XDM) 系统：用于实现此目标的标准化框架 Experience Platform 组织客户体验数据。
  • 模式组合基础：了解XDM架构的基本构建基块，包括架构构成中的关键原则和最佳实践。
  • 架构编辑器教程：了解如何使用架构编辑器UI创建自定义架构。
• Real-Time Customer Profile：根据来自多个来源的汇总数据提供统一的实时使用者个人资料。

创建流连接

在Platform UI中，选择 源 从左侧导航访问 源 工作区。 此 目录 屏幕中显示多种来源，您可以使用这些来源创建帐户。

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

在 流 类别，选择 HTTP API 然后选择 添加数据.

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

现有帐户

要使用现有帐户，请选择要用于创建新数据流的HTTP API帐户，然后选择 下一个 以继续。

新帐户

如果要创建新帐户，请选择 新帐户. 在出现的输入表单上，提供帐户名称和可选描述。 您还可以选择提供以下配置属性：

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

完成后，选择 连接到源 然后选择 下一个 以继续。

选择数据

创建HTTP API连接后， 选择数据 此时会显示步骤，为您提供上传和预览数据的界面。

选择 上载文件 以上传您的数据。 或者，您可以将数据拖放到 拖放文件 部分。

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

将数据字段映射到XDM架构

此 映射 此时会显示步骤，其中提供了一个将源数据映射到Platform数据集的界面。

此 HTTP API 源支持JSON文件的摄取。 如果将JSON文件标记为XDM投诉，则无需手动配置。 如果没有，则必须显式配置映射。

选择要引入的集客数据的数据集。 您可以使用现有数据集或创建新数据集。

创建新数据集

要创建新数据集，请选择 新数据集. 在显示的表单上，提供名称、可选描述以及数据集的目标架构。 如果您选择 Profile-enabled架构，您可以选择数据集是否还应 Profile-enabled。

使用现有数据集

要使用现有数据集，请选择 现有数据集. 在显示的表单上，选择要使用的数据集。 选择数据集后，您可以选择数据集是否应 Profile-enabled。

映射标准字段

根据需要，您可以选择直接映射字段，或使用数据准备函数转换源数据以派生计算值或计算值。 有关使用映射器界面和计算字段的全面步骤，请参阅 数据准备UI指南.

要添加新源字段，请选择 添加新映射.

此时将显示一个新的源字段与目标字段配对。 要添加新源字段，请选择 选择源字段 输入栏。

此 选择属性 使用此面板，可浏览文件层次结构并选择要映射到目标XDM字段的特定源字段。 选择要映射的源字段后，选择 选择 以继续。

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

此 将源字段映射到目标字段 窗口，为您提供用于浏览目标数据集架构的界面。 选择与源字段匹配的目标字段，然后选择 选择 以继续。

将源字段全部映射到相应的目标XDM字段后，选择 下一个

数据流详细信息

此 数据流详细信息 此时将显示步骤。 在此页上，可以通过提供名称和可选描述来提供已创建数据流的详细信息。

为数据流提供详细信息后，选择 下一个.

请查看

此 审核 此时会显示步骤，允许您在创建数据流之前查看其详细信息。 详细信息分为以下类别：

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

确认详细信息正确后，选择 完成.

获取流端点URL

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

后续步骤

通过遵循本教程，您已创建一个流HTTP连接，使您能够使用流端点访问各种 Data Ingestion API。 有关在API中创建流连接的说明，请参阅 创建流连接教程.

要了解如何将数据流式传输到Platform，请阅读以下任一教程： 流式时间序列数据 或上的教程 流记录数据.