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

在用户界面中创建Chatlio源连接

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

本教程提供了使用Adobe Experience Platform用户界面创建Chatlio源连接的步骤。

快速入门 getting-started

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

先决条件 prerequisites

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

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

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

{
  "visitor": {
    "email": "test@example.com",
    "UUID": "2d3f4260-2235-903b-0a82-a23d326cc257"
  },
   "message": "Hi",
  "channelId": "C04J7M7LCMQ",
  "slackChannelName": "aep",
  "slackChannelId": "C04JVR71WKS"
}

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

您还必须确保创建用于源的Platform架构。 阅读有关创建平台架构的教程,了解有关如何创建架构的完整步骤。

平台UI显示Chatlio的示例架构

连接您的Chatlio帐户 connect-account

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

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

转到营销自动化类别以查看Chatlio源卡。 要开始,请选择​ 添加数据

包含聊天卡的Platform UI目录

选择数据 select-data

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

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

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

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

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

完成后,选择​ 下一步

源工作流的预览步骤。

数据流详细信息 dataflow-detail

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

完成后,选择​ 下一步

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

映射 mapping

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

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

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

目标字段
描述
UUID
事件的Chatlio标识符。

成功映射源数据后,选择​ 下一步

源工作流的映射步骤。

审查 review

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

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

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

源工作流的审核步骤。

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

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

要构造用于在Chatlio上配置webhook的URL,您必须检索以下内容:

  • 数据流ID
  • 流式处理终结点

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

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

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

在Chatlio中设置webhook set-up-webhook

创建webhook URL后,您现在可以使用Chatlio用户界面设置webhook。

登录您的Chatlio帐户,并按照设置和安装指南创建构件。

创建构件后,导航到构件的设置页面以将webhook URL添加到该构件。

Chatlio上的webhook设置页面。

接下来,选择​ Behavior ​选项卡,并将您的webhook URL添加到​ Webhook when a new conversation starts ​字段以及要订阅的任何其他webhook事件字段。

显示webhook终结点字段的Chatlio UI。

TIP
您可以为Chatlio webhook订阅各种不同的活动。 有关不同事件的详细信息,请参阅Chatlio 事件文档

后续步骤 next-steps

通过完成本教程,您已成功配置流式数据流以将您的Chatlio数据引入Experience Platform。 要监视正在摄取的数据,请参阅有关使用Platform UI监视流式数据流的指南

其他资源 additional-resources

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

验证 validation

要验证您是否已正确设置源,并且正在摄取Chatlio条消息,请执行以下步骤:

  • 您可以检查Chatlio 报告 > 聊天历史记录 ​页面以识别Chatlio正在捕获的事件。

Chatlio UI屏幕截图显示聊天历史记录

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

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

有关Chatlio的其他信息,请访问Chatlio 文档常见问题解答

recommendation-more-help
337b99bb-92fb-42ae-b6b7-c7042161d089