摄取和使用流式数据
本快速入门指南介绍了如何将流数据导入 Adobe Experience Platform,然后在 Customer Journey Analytics 中使用这些数据。
要完成此实施,您需要:
-
在 Adobe Experience Platform 中 设置模式和数据集 ,以定义要收集的数据的模型(模式)以及实际收集数据的位置(数据集)。
-
使用 HTTP API 源连接器 可以轻松地将数据流到 Adobe Experience Platform 中配置的数据集中。
-
在 Customer Journey Analytics 中 设置连接。此连接应(至少)包含 Adobe Experience Platform 数据集。
-
在 Customer Journey Analytics 中 设置数据视图 以定义要在 Analysis Workspace 中使用的量度和维度。
-
在 Customer Journey Analytics 中 设置一个项目 以构建报告和可视化图表。
设置模式和数据集
要将数据摄取到Adobe Experience Platform,您必须首先定义要收集的数据。 引入 Adobe Experience Platform 的所有数据都必须符合标准的非规范化结构,以便下游功能和特性对其进行识别和操作。体验数据模型 (XDM) 是以模式形式提供此结构的标准框架。
定义模式后,您可以使用一个或多个数据集来存储和管理数据集合。数据集是用于数据集合(通常是表)的存储和管理结构,其中包含架构(列)和字段(行)。
摄取到 Adobe Experience Platform 中的所有数据都必须符合预定义的模式,然后才能作为数据集保存。
设置模式
为了快速开始,您需要收集一些忠诚度数据,例如忠诚度 id、忠诚度积分和忠诚度状态。您必须首先定义一个模式来模拟此数据。
设置您的模式:
-
在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的 模式。
-
选择 创建架构。
. -
在“创建模式”向导的“选择类”步骤中:
-
选择 个人资料。
note info INFO 体验事件架构用于为配置文件的_行为_建模(如场景名称、要添加到购物车的按钮)。 个人配置档案模式用于对个人配置档案_属性_(如姓名、电子邮件、性别)建模。 -
选择 下一步。
-
-
在创建架构向导的名称和审核步骤中:
-
为您的架构输入 架构显示名称 和(可选)描述。
-
选择 完成。
-
-
在示例架构的结构选项卡中:
-
在字段组中选择 + 添加。
字段组是可重用的对象和属性集合,可让您轻松扩展模式。
-
在添加字段组对话框中,从列表中选择 忠诚度详细信息 字段组。
您可以选择预览按钮,以查看属于该字段组的字段的预览。
选择 返回 关闭预览。
-
选择 添加字段组。
-
-
在结构面板中选择模式名称旁边的 +。
-
在字段属性面板中,输入
Identification
作为名称,识别 作为显示名称,选择 对象 作为类型和选择 配置核心文件 v2 作为字段组。此标识对象将标识功能添加到架构中。 在您的情况下,您希望使用批处理数据中的电子邮件地址来识别忠诚度信息。
选择 应用 将此对象添加到您的模式中。
-
选择刚刚添加的标识对象中的 邮件 字段,选择 标识 和 邮件 和标识命名空间中的字段属性面板。
您将电子邮件地址指定为 Adobe Experience Platform Identity 服务可用于组合(拼接)配置文件行为的标识。
选择 应用。您会看到电子邮件属性中显示指纹图标。
-
选择模式的根级别(使用模式名称),然后选择 配置 开关。
系统会提示您启用配置文件的模式。一旦启用,当数据被引入基于此模式的数据集中时,该数据将合并到实时客户配置文件。
有关详细信息,请参阅启用模式以在实时客户配置文件中使用。
note important IMPORTANT 一旦您保存了为配置文件启用的模式,就不能再为配置文件禁用它。 -
选择 保存 以保存模式。
您已经创建了一个最小的模式,它可以对可以引入 Adobe Experience Platform 的忠诚度数据进行建模。该模式允许使用电子邮件地址标识配置文件。通过为概要文件启用模式,可以确保流媒体源添加到实时客户配置文件中。
请参阅在 UI 中创建和编辑模式,了解有关向模式添加和删除字段组和单个字段的更多信息。
设置数据集
使用您的模式,您已经定义了数据模型。现在,您必须定义构建来存储和管理这些数据,这通过数据集来完成。
设置您的数据集
-
在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的 数据集。
-
选择 创建数据集。
-
选择 使用模式创建数据集。
。
-
选择您之前创建的模式,然后选择 下一个。
-
为您的数据集命名并(可选)提供描述。
-
选择 完成。
-
选择 配置文件 开关
系统会提示您启用配置文件的数据集。启用后,数据集会使用其摄取的数据丰富实时客户配置文件。
note important IMPORTANT 只有当数据集所依附的模式也为配置文件启用时,您才能为配置文件启用数据集。
有关如何查看、预览、创建和删除数据集的更多信息,请参阅数据集 UI 指南。以及如何为实时客户配置文件启用数据集。
设置 HTTP API 流连接
您的源应用程序流式传输符合您创建的模式的数据,并且看起来像下面这样。
{
...
"_demosystem4": {
"identification": {
"core": {
"email": "abrocking0@blog.com",
"loyaltyId": "793406",
}
}
},
"loyalty": {
"loyaltyID": [
"793406"
],
"points": 82.16,
"status": "Silver"
}
...
}
要将此数据流式传输到您创建的数据集,您必须为要发送的数据定义流式端点。 使用HTTP API源连接器创建流端点。
要创建 HTTP API 源连接器:
-
在 Experience Platform UI 的左边栏中,选择源中的 连接。
-
从 类别 列表中选择 数据流。
-
在 HTTP API 磁贴中选择 设置。
-
在添加数据屏幕的Authentication步骤中:
输入 HTTP API 连接的名称和描述。
选择 XDM 兼容性 以指示流式传输的数据与现有 XDM 模式兼容。
选择 连接到源。连接成功后,您会看到Connected。
选择 下一步 以继续。
-
在添加数据屏幕的数据流详细信息步骤中:
选择 现有数据集,从数据集列表中选择您的数据集,然后命名您的数据流名称。
选择 下一步。
-
检查添加数据屏幕的步骤为您提供了 HTTP API 连接的概览。
选择 完成。
-
您可以看到 HTTP API 流端点的最终定义。
您可以复制流式端点 URL 并使用它来配置您的忠诚度应用程序以将数据流式传输到 Adobe Experience Platform 忠诚度数据集中。
有关更全面的教程说明,请参阅使用UI创建HTTP API流连接:
- 如何使用身份验证,
- 当传入数据与XDM架构不兼容时如何映射数据,以及
- 如何在设置流连接器过程中创建数据集。
设置连接
要在 Customer Journey Analytics 中使用 Adobe Experience Platform 数据,您需要创建一个连接,其中包含因设置模式、数据集和工作流所产生的数据。
通过创建连接,您可以将 Adobe Experience Platform 中的数据集集成到工作区中。要报告这些数据集,您必须首先在Adobe Experience Platform和Workspace中的数据集之间建立连接。
创建您的连接:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 连接。
-
选择 创建新连接。
-
在无标题连接屏幕中:
在连接设置中命名并描述您的连接。
从数据设置中的沙盒列表中选择正确的沙盒,并从平均每日事件数列表中选定每日事件数。
选择 添加数据集。
在添加数据集的选择数据集步骤中:
-
选择先前(
Example Loyalty Dataset
)创建的数据集以及要包含在连接中的任何其他数据集。 -
选择 下一步。
在添加数据集的设置数据集步骤中:
-
对于每个数据集:
-
在 Adobe Experience Platform 中,从在数据集模式中定义的可用身份中选择人员 ID。
-
从数据源类型列表中选择正确的数据源。如果指定 其他,则为您的数据源添加描述。
-
根据您的首选项设置 导入所有新数据 和 数据集回填现有数据。
-
-
选择 添加数据集。
选择 保存。
-
有关如何创建和管理连接以及如何选择和组合数据集的更多信息请参阅连接概述。
设置数据视图
数据视图是 Customer Journey Analytics 专属的容器,通过它,可决定如何解释来自连接的数据。 它指定所有可在 Analysis Workspace 中找到的维度和量度,以及这些维度和量度从哪些列获取其数据。为准备 Analysis Workspace 中的报告而定义数据视图。
创建您的数据视图:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 数据视图。
-
选择 创建新数据视图。
-
在配置步骤中:
从连接列表中选择您的连接。
名称并(可选)描述您的连接。
选择 保存并继续。
-
在组件步骤中:
将要包含的任何模式字段和/或标准组件添加到量度或维度组件框中。
选择 保存并继续。
-
在设置步骤中:
保持设置不变并选择 保存并完成。
请参阅数据视图概述,了解有关如何创建和编辑数据视图、哪些组件可供您在数据视图中使用以及如何使用过滤器和会话的更多信息设置。
设置项目
Analysis Workspace 是一个灵活的浏览器工具,允许您快速构建分析并基于数据共享见解。您可以使用工作区项目来组合数据组件、表和可视化,以制作分析并与组织中的任何人共享。
要创建您的项目:
-
在 Customer Journey Analytics UI 中,选择顶部导航中的 项目。
-
选择左侧导航中的 项目。
-
选择 创建项目。
选择 空白项目。
-
从列表中选择您的数据视图。
-
要创建您的第一个报告,请在面板中的自由格式表上开始拖放维度和量度。 例如,拖动
Program Points Balance
以及Page View
作为量度和email
作为维度,以快速查看访问过您的网站并已加入忠诚度计划收集忠诚度点的个人资料。
请参阅 Analysis Workspace 概述,了解有关如何使用组件、可视化和面板创建项目和构建分析的更多信息。