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

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

NOTE
此 Customer.io 源为测试版。 请阅读 源概述 有关使用测试版标记源代码的更多信息。

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

快速入门 getting-started

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

先决条件 prerequisites

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

用于定义源架构的JSON示例 Customer.io 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架构。 请参阅上的教程 创建平台架构 以了解有关如何创建模式的完整步骤。

Platform UI屏幕截图显示了Customer.io架构示例

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

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

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

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

带有Customer.io卡的目录的平台UI屏幕截图

选择数据 select-data

选择数据 此时会显示步骤,提供一个界面供您选择要带到Platform的数据。

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

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

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

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

完成后,选择 下一个.

源工作流的预览步骤。

数据流详细信息 dataflow-detail

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

完成后,选择 下一个.

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

映射 mapping

此 映射 此时会显示步骤,为您提供用于将源架构中的源字段映射到目标架构中相应的目标XDM字段的界面。

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

下面列出的所有映射都是强制性的,应在继续执行 审核 暂存。

目标字段
描述
object_type
对象类型,请参阅 Customer.io 事件 文档以了解支持的类型。
id
对象的标识符。
email
与对象关联的电子邮件地址。
event_id
事件的唯一标识符。
cio_id
此 Customer.io 事件的标识符。
metric
事件类型。 欲了解更多信息,请参见 Customer.io 事件 文档以了解支持的类型。
timestamp
事件发生时的时间戳。
IMPORTANT
不映射 cio_id 执行时 Customer.io 中的webhook test mode 因为将不会发送任何关联的字段 Customer.io.

成功映射源数据后,选择 下一个.

源工作流的映射步骤。

请查看 review

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

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

查看数据流后,选择 完成 留出一段时间来创建数据流。

源工作流的审核步骤。

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

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

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

  • 数据流ID
  • 流端点

检索您的 数据流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

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

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

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

显示webhook端点字段的Customer.io用户界面

TIP
您可以为报表webhook订阅各种不同的事件。 每个事件的消息将在以下情况下摄取到Platform: Customer.io 满足操作事件触发器条件。 有关不同事件的详情,请参阅 Customer.io 事件文档.

后续步骤 next-steps

通过学习本教程,您已成功配置了一个流数据流,将 Customer.io 要Experience Platform的数据。 要监视正在摄取的数据,请参阅上的指南 使用Platform UI监控流数据流.

其他资源 additional-resources

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

护栏 guardrails

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

验证 validation

验证是否已正确设置源和 Customer.io 正在摄取消息,请执行以下步骤:

  • 您可以检查 Customer.io 活动日志 页面识别捕获的事件 Customer.io.

Customer.io UI屏幕截图显示活动日志

  • 在Platform UI中,选择 查看数据流 在 Customer.io 源目录上的卡菜单。 接下来,选择 预览数据集 验证为您在中选择的事件摄取的数据 Customer.io.

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

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