[Beta 版]{class="badge informative"}

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

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

NOTE

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

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

快速入门 getting-started

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

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

先决条件 prerequisites

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

用于为Pendo定义源架构的JSON示例 prerequisites-json-schema

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

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

有关详细信息，请阅读webhooks🔗上的Pendo 指南。

为Pendo创建平台架构 create-platform-schema

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

Platform UI显示Pendo的示例架构。

连接您的Pendo帐户 connect-account

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

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

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

带有Pendo卡的Platform UI源目录。

选择数据 select-data

此时将显示 选择数据 步骤，该步骤为您提供了一个用于选择要导入到Platform的数据的界面。

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

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

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

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

完成后，选择 下一步。

源工作流的预览步骤。

数据流详细信息 dataflow-detail

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

完成后，选择 下一步。

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

映射 mapping

此时将显示映射步骤，该步骤为您提供了一个接口，用于将源架构中的源字段映射到目标架构中相应的目标XDM字段。

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

下面列出的映射是强制性的，应在继续执行审阅阶段之前进行设置。

目标字段

描述

uniqueId

事件的Pendo标识符。

成功映射源数据后，选择 下一步。

源工作流的映射步骤。

审查 review

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

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

查看数据流后，选择完成，然后等待一些时间来创建数据流。

源工作流的审核步骤。

获取您的流端点URL get-streaming-endpoint-url

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

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

数据流ID
流式处理终结点

要检索 数据流ID 和 流式处理终结点，请转到刚刚创建的数据流的数据流活动页面，并从属性面板的底部复制详细信息。

数据流活动中的流终结点。

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