Beta 版

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

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

此 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架构。 请参阅上的教程 创建平台架构 以了解有关如何创建模式的完整步骤。

平台UI,其中显示了Pendo的示例架构。

连接您的 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 ,并在 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 帮助中心.

在此页面上