创建 HTTP API 使用UI流式连接

上次更新: 2023-11-14
  • 主题:
  • Sources
    查看有关此主题的更多信息
  • 创建对象:
  • Developer
    User
    Admin
    Leader

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

快速入门

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

创建流连接

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

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

类别,选择 HTTP API 然后选择 添加数据.

目录

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

现有帐户

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

existing-account

新帐户

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

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

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

new-account

选择数据

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

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

add-data

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

preview-sample-data

将数据字段映射到XDM架构

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

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

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

创建新数据集

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

new-dataset

使用现有数据集

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

existing-dataset

映射标准字段

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

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

add-new-mapping

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

select-source-field

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

select-attribute

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

select-target-field

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

映射到目标字段

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

data-prep-complete

数据流详细信息

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

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

数据流详细信息

请查看

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

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

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

审核

获取流端点URL

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

端点

后续步骤

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

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

在此页面上