Beta 版

创建 Pendo 源连接数据流和UI中

本教程提供了用于创建 Pendo 源连接和数据流(使用Adobe Experience Platform用户界面)。

快速入门

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

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

先决条件

以下部分提供了在创建之前，需要完成的先决条件的信息 Pendo 源连接。

用于定义源架构的JSON示例 Pendo

创建之前 Pendo 源连接，您需要提供源架构。 您可以使用下面的JSON。

{
  "accountId": "58f79ee324d3f",
  "timestamp": 1673372516,
  "visitorId": "test@test.com",
  "uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
  "properties": {
    "guideProperties": {
  "name": "Guide Conversion Test"
  }
}
}

欲知更多信息，请参阅 Pendo webhook指南.

为创建平台架构 Pendo

您还必须确保首先创建用于源的Platform架构。 请参阅上的教程 创建平台架构 以了解有关如何创建模式的完整步骤。

连接您的 Pendo 帐户

在Platform UI中，选择 源 从左侧导航访问 源 并查看Experience Platform中可用的源目录。

使用 类别 菜单，用于按类别筛选源。 或者，在搜索栏中输入源名称，以从目录查找特定源。

转到 分析 类别以查看 Pendo 源卡。 要开始，请选择 添加数据.

选择数据

此 选择数据 此时会显示步骤，提供一个界面供您选择要带到Platform的数据。

• 界面的左侧是一个浏览器，允许您查看帐户内的可用数据流；
• 界面的右侧部分允许您预览JSON文件中最多100行数据。

选择 上载文件 以从本地系统上传JSON文件。 或者，您也可以将要上传的JSON文件拖放到 拖放文件 面板。

上传文件后，预览界面会更新，以显示您上传的架构预览。 预览界面允许您检查文件的内容和结构。 您也可以使用 搜索字段 用于从架构中访问特定项目的实用程序。

完成后，选择 下一个.

数据流详细信息

此 数据流详细信息 此时会显示步骤，为您提供使用现有数据集或为数据流建立新数据集的选项，以及提供数据流名称和描述的机会。 在此步骤中，您还可以配置配置文件摄取、错误诊断、部分摄取和警报的设置。

完成后，选择 下一个.

映射

此 映射 此时会显示步骤，为您提供用于将源架构中的源字段映射到目标架构中相应的目标XDM字段的界面。

Platform根据您选择的目标架构或数据集，为自动映射的字段提供智能推荐。 您可以手动调整映射规则以适合您的用例。 根据需要，您可以选择直接映射字段，或使用数据准备函数转换源数据以派生计算值或计算值。 有关使用映射器界面和计算字段的全面步骤，请参阅 数据准备UI指南.

下面列出的映射是强制性的，应在继续执行 审核 暂存。

成功映射源数据后，选择 下一个.

请查看

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

• 连接：显示源类型、所选源文件的相关路径以及该源文件中的列数。
• 分配数据集和映射字段：显示要将源数据摄取到哪个数据集，包括数据集所遵循的架构。

查看数据流后，选择 完成 留出一段时间来创建数据流。

获取您的流端点URL

创建流数据流后，您现在可以检索流端点URL。 此端点将用于订阅您的webhook，允许您的流源与Experience Platform通信。

用于构造用于在上配置webhook的URL Pendo 您必须检索以下内容：

• 数据流ID
• 流端点

检索您的 数据流ID 和 流端点，转到 数据流活动 创建的数据流页面，并从页面底部复制详细信息 属性 面板。

在检索到流端点和数据流ID后，请基于以下模式构建URL： {STREAMING_ENDPOINT}?x-adobe-flow-id={DATAFLOW_ID}. 例如，构建的webhook URL可能如下所示： https://dcs.adobedc.net/collection/0c61859cc71939a0caf01123f91b2fc52589018800ad46b6c76c2dff3595ee95

在中设置Webhook Pendo

接下来，登录您的帐户，网址为 Pendo 并创建一个webhook。 有关如何使用创建webhook的步骤 Pendo 用户界面，请参阅 Pendo 有关创建webhook的指南.

创建webhook后，导航到 Pendo webhook ，并在 URL 字段。

后续步骤

通过学习本教程，您已成功配置了一个流数据流，将 Pendo 要Experience Platform的数据。 要监视正在摄取的数据，请参阅上的指南 使用Platform UI监控流数据流.

其他资源

以下各节提供了在使用时，您可以参考的其他资源 Pendo 源。

验证

验证是否已正确设置源和 Pendo 正在摄取消息，请执行以下步骤：

• 您可以检查 Pendo 报表 > 聊天历史记录 页面识别捕获的事件 Pendo.

• 在Platform UI中，选择 查看数据流 在 Pendo 源目录上的卡菜单。 接下来，选择 预览数据集 验证为您在中配置的Webhook摄取的数据 Pendo.

错误和故障排除

检查数据流运行时，您可能会遇到以下错误消息： The message can't be validated ... uniqueID:expected minLength:1, actual 0].

要修复此错误，您必须验证 唯一标识符 已设置映射。 有关其他指导，请参阅 Mmping 部分。

欲知更多信息，请访问 Pendo 帮助中心.