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

在UI中创建Customer.io源连接和数据流

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

快速入门 getting-started

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

先决条件 prerequisites

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

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

在创建Customer.io源连接之前，您需要提供源架构。 您可以使用以下JSON。

{
  "event_id": "01E4C4CT6YDC7Y5M7FE1GWWPQJ",
  "object_type": "customer",
  "metric": "subscribed",
  "timestamp": 1613063089,
  "data": {
    "customer_id": "42",
    "email_address": "test@example.com",
    "identifiers": {
      "id": "42",
      "email": "test@example.com",
      "cio_id": "d9c106000001"
    }
  }
}

为Customer.io创建平台架构 create-platform-schema

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

连接您的Customer.io帐户 connect-account

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

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

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

带有Customer.io卡的目录

选择数据 select-data

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

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

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

完成后，选择​ 下一步。

数据流详细信息 dataflow-detail

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

完成后，选择​ 下一步。

映射 mapping

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

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

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

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

审查 review

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

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

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

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

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

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

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

在Customer.io中设置报告webhook set-up-webhook

创建webhook URL后，您现在可以使用Customer.io用户界面设置报表webhook。 有关设置报表Webhook的步骤，请阅读有关设置Webhook的Customer.io 指南。

在Customer.io用户界面的WEBHOOK ENDPOINT字段中输入webhook URL。

后续步骤 next-steps

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

其他资源 additional-resources

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

护栏 guardrails

有关护栏的信息，请参阅Customer.io 超时和失败页面。

验证 validation

要验证您是否已正确设置源，并且正在摄取Customer.io条消息，请执行以下步骤：