测试版

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

注意

此 Pendo 源为测试版。 请参阅 源概述 有关使用测试版标记源的更多信息。

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

快速入门

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

先决条件

以下部分提供了在创建之前,需要完成的先决条件的信息 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架构的平台UI。

连接您的 Pendo 帐户

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

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

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

带有Pendo卡的Platform UI源目录。

选择数据

选择数据 步骤,为您提供了一个界面来选择要带到Platform的数据。

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

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

源工作流的添加数据步骤。

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

完成后,选择 下一个.

源工作流的预览步骤。

数据流详细信息

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

完成后,选择 下一个.

源工作流的数据流详细信息步骤。

映射

此 映射 步骤随即显示,为您提供了一个界面,用于将源架构中的源字段映射到目标架构中相应的目标XDM字段。

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

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

目标字段 描述
uniqueId 此 Pendo 事件的标识符。

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

源工作流的映射步骤。

请查看

审核 步骤,允许您在创建新数据流之前对其进行查看。 详细信息分为以下类别:

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

查看数据流后,选择 完成 并留出一些时间来创建数据流。

源工作流的审核步骤。

获取您的流端点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并将您的webhook URL输入 URL 字段。

显示webhook端点字段的Pendo UI屏幕截图

小贴士

您可以订阅各种不同的事件类别,以确定要从发送何种事件 Pendo 实例到Platform。 欲知不同事件的详情,请参阅 Pendo 文档.

后续步骤

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

其他资源

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

验证

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

  • 您可以检查 Pendo 报告 > 聊天历史记录 用于标识所捕获的事件的页面 Pendo.

显示聊天历史记录的Pendo UI屏幕快照

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

显示已摄取事件的平台UI屏幕截图

错误和疑难解答

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

平台UI屏幕截图显示错误。

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

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

在此页面上