创建 Pendo 源连接数据流和UI中
本教程提供了用于创建 Pendo 源连接和数据流(使用Adobe Experience Platform用户界面)。
快速入门 getting-started
本教程需要对以下Experience Platform组件有一定的了解:
-
Experience Data Model (XDM) 系统:用于实现此目标的标准化框架 Experience Platform 组织客户体验数据。
-
Real-Time Customer Profile:根据来自多个来源的汇总数据提供统一的实时使用者个人资料。
先决条件 prerequisites
以下部分提供了在创建之前,需要完成的先决条件的信息 Pendo 源连接。
用于定义源架构的JSON示例 Pendo prerequisites-json-schema
创建之前 Pendo 源连接,您需要提供源架构。 您可以使用下面的JSON。
{
"accountId": "58f79ee324d3f",
"timestamp": 1673372516,
"visitorId": "test@test.com",
"uniqueId": "166e50cdf40930fe1367e4d44795c9c74d88b83a",
"properties": {
"guideProperties": {
"name": "Guide Conversion Test"
}
}
}
欲知更多信息,请参阅 Pendo webhook指南.
为创建平台架构 Pendo create-platform-schema
您还必须确保首先创建用于源的Platform架构。 请参阅上的教程 创建平台架构 以了解有关如何创建模式的完整步骤。
连接您的 Pendo 帐户 connect-account
在Platform UI中,选择 源 从左侧导航访问 源 并查看Experience Platform中可用的源目录。
使用 类别 菜单,用于按类别筛选源。 或者,在搜索栏中输入源名称,以从目录查找特定源。
转到 分析 类别以查看 Pendo 源卡。 要开始,请选择 添加数据.
选择数据 select-data
此 选择数据 此时会显示步骤,提供一个界面供您选择要带到Platform的数据。
- 界面的左侧是一个浏览器,允许您查看帐户内的可用数据流;
- 界面的右侧部分允许您预览JSON文件中最多100行数据。
选择 上载文件 以从本地系统上传JSON文件。 或者,您也可以将要上传的JSON文件拖放到 拖放文件 面板。
上传文件后,预览界面会更新,以显示您上传的架构预览。 预览界面允许您检查文件的内容和结构。 您也可以使用 搜索字段 用于从架构中访问特定项目的实用程序。
完成后,选择 下一个.
数据流详细信息 dataflow-detail
此 数据流详细信息 此时会显示步骤,为您提供使用现有数据集或为数据流建立新数据集的选项,以及提供数据流名称和描述的机会。 在此步骤中,您还可以配置配置文件摄取、错误诊断、部分摄取和警报的设置。
完成后,选择 下一个.
映射 mapping
此 映射 此时会显示步骤,为您提供用于将源架构中的源字段映射到目标架构中相应的目标XDM字段的界面。
Platform根据您选择的目标架构或数据集,为自动映射的字段提供智能推荐。 您可以手动调整映射规则以适合您的用例。 根据需要,您可以选择直接映射字段,或使用数据准备函数转换源数据以派生计算值或计算值。 有关使用映射器界面和计算字段的全面步骤,请参阅 数据准备UI指南.
下面列出的映射是强制性的,应在继续执行 审核 暂存。
uniqueId
成功映射源数据后,选择 下一个.
请查看 review
此 审核 此时会显示步骤,允许您在创建新数据流之前对其进行查看。 详细信息分为以下类别:
- 连接:显示源类型、所选源文件的相关路径以及该源文件中的列数。
- 分配数据集和映射字段:显示要将源数据摄取到哪个数据集,包括数据集所遵循的架构。
查看数据流后,选择 完成 留出一段时间来创建数据流。
获取您的流端点URL get-streaming-endpoint-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 set-up-webhook
接下来,登录您的帐户,网址为 Pendo 并创建一个webhook。 有关如何使用创建webhook的步骤 Pendo 用户界面,请参阅 Pendo 有关创建webhook的指南.
创建webhook后,导航到 Pendo webhook ,并在 URL 字段。
后续步骤 next-steps
通过学习本教程,您已成功配置了一个流数据流,将 Pendo 要Experience Platform的数据。 要监视正在摄取的数据,请参阅上的指南 使用Platform UI监控流数据流.
其他资源 additional-resources
以下各节提供了在使用时,您可以参考的其他资源 Pendo 源。
验证 validation
验证是否已正确设置源和 Pendo 正在摄取消息,请执行以下步骤:
- 您可以检查 Pendo 报表 > 聊天历史记录 页面识别捕获的事件 Pendo.
- 在Platform UI中,选择 查看数据流 在 Pendo 源目录上的卡菜单。 接下来,选择 预览数据集 验证为您在中配置的Webhook摄取的数据 Pendo.
错误和故障排除 errors-and-troubleshooting
检查数据流运行时,您可能会遇到以下错误消息: The message can't be validated ... uniqueID:expected minLength:1, actual 0].
要修复此错误,您必须验证 唯一标识符 已设置映射。 有关其他指导,请参阅 Mmping 部分。
欲知更多信息,请访问 Pendo 帮助中心.