摄取和使用流式数据

本快速入门指南介绍了如何将流数据导入 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 中​ 设置一个项目 ​以构建报告和可视化图表。

NOTE
本快速入门指南是一份有关如何将流数据摄取到Adobe Experience Platform并在Customer Journey Analytics中使用的简化指南。 强烈建议参考时研究附加信息。

设置模式和数据集

要将数据摄取到Adobe Experience Platform,您必须首先定义要收集的数据。 引入 Adobe Experience Platform 的所有数据都必须符合标准的非规范化结构,以便下游功能和特性对其进行识别和操作。体验数据模型 (XDM) 是以模式形式提供此结构的标准框架。

定义模式后,您可以使用一个或多个数据集来存储和管理数据集合。数据集是用于数据集合(通常是表)的存储和管理结构,其中包含架构(列)和字段(行)。

摄取到 Adobe Experience Platform 中的所有数据都必须符合预定义的模式,然后才能作为数据集保存。

设置模式

为了快速开始,您需要收集一些忠诚度数据,例如忠诚度 id、忠诚度积分和忠诚度状态。您必须首先定义一个模式来模拟此数据。

设置您的模式:

  1. 在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的​ 模式

  2. 选择 创建架构

  3. 在“创建模式”向导的“选择类”步骤中:

    1. 选择 个人资料.

      创建模式

      note info
      INFO
      Experience Event架构用于为 行为 配置文件(如场景名称、要添加到购物车的按钮)的。 个人配置档案模式用于对个人配置档案​_属性_(如姓名、电子邮件、性别)建模。
    2. 选择​ 下一步

  4. 在 命名和审核步骤 的 创建架构 向导:

    1. 输入 架构显示名称 (可选)a 描述.

      命名您的模式

    2. 选择​ 完成

  5. 在示例架构的结构选项卡中:

    1. 在字段组中选择​ + 添加

      添加字段组

      字段组是可重用的对象和属性集合,可让您轻松扩展模式。

    2. 在添加字段组对话框中,从列表中选择​ 忠诚度详细信息 ​字段组。

      AEP Web SDK ExperienceEvent 字段组

      您可以选择预览按钮,以查看属于该字段组的字段的预览。

      AEP Web SDK ExperienceEvent 字段组预览

      选择​ 返回 ​关闭预览。

    3. 选择​ 添加字段组

  6. 在结构面板中选择模式名称旁边的 +

    示例模式添加字段按钮

  7. 在字段属性面板中,输入Identification作为名称,识别 ​作为显示名称,选择​ 对象 ​作为类型和选择​ 配置核心文件 v2 ​作为字段组。

    识别对象

    此标识对象将标识功能添加到架构中。 在您的情况下,您希望使用批处理数据中的电子邮件地址来识别忠诚度信息。

    选择​ 应用 ​将此对象添加到您的模式中。

  8. 选择刚刚添加的标识对象中的​ 邮件 ​字段,选择​ 标识 ​和​ 邮件 ​和标识命名空间中的字段属性面板。

    将电子邮件指定为标识

    您将电子邮件地址指定为 Adobe Experience Platform Identity 服务可用于组合(拼接)配置文件行为的标识。

    选择​ 应用。您会看到电子邮件属性中显示指纹图标。

  9. 选择模式的根级别(使用模式名称),然后选择​ 配置 ​开关。

    系统会提示您启用配置文件的模式。一旦启用,当数据被引入基于此模式的数据集中时,该数据将合并到实时客户配置文件。

    有关详细信息,请参阅启用模式以在实时客户配置文件中使用

    note important
    IMPORTANT
    一旦您保存了为配置文件启用的模式,就不能再为配置文件禁用它。

    为配置文件启用模式

  10. 选择​ 保存 ​以保存模式。

您已经创建了一个最小的模式,它可以对可以引入 Adobe Experience Platform 的忠诚度数据进行建模。该模式允许使用电子邮件地址标识配置文件。通过为概要文件启用模式,可以确保流媒体源添加到实时客户配置文件中。

请参阅在 UI 中创建和编辑模式,了解有关向模式添加和删除字段组和单个字段的更多信息。

设置数据集

使用您的模式,您已经定义了数据模型。现在,您必须定义构建来存储和管理这些数据,这通过数据集来完成。

设置您的数据集

  1. 在 Adobe Experience Platform UI 的左边栏中,选择数据管理中的​ 数据集

  2. 选择​ 创建数据集

    创建数据集

  3. 选择​ 使用模式创建数据集

    使用模式创建数据集

  4. 选择您之前创建的模式,然后选择 下一个

  5. 为您的数据集命名并(可选)提供描述。

    数据集名称

  6. 选择​ 完成

  7. 选择​ 配置文件 ​开关

    系统会提示您启用配置文件的数据集。启用后,数据集会使用其摄取的数据丰富实时客户配置文件。

    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 源连接器:

  1. 在 Experience Platform UI 的左边栏中,选择源中的​ 连接

  2. 从 类别 列表中选择 数据流

  3. 在 HTTP API 磁贴中选择​ 设置

    设置 HTTP API tile

  4. 在添加数据屏幕的Authentication步骤中:

    输入 HTTP API 连接的名称和描述。

    选择 XDM 兼容性 ​以指示流式传输的数据与现有 XDM 模式兼容。

    选择​ 连接到源。连接成功后,您会看到Connected。

    HTTP API 身份验证

    选择​ 下一步 ​以继续。

  5. 在添加数据屏幕的数据流详细信息步骤中:

    选择​ 现有数据集,从数据集列表中选择您的数据集,然后命名您的数据流名称。

    数据流详细信息

    选择​ 下一步

  6. 检查添加数据屏幕的步骤为您提供了 HTTP API 连接的概览。

    数据流详细信息

    选择​ 完成

  7. 您可以看到 HTTP API 流端点的最终定义。

    HTTP API 流端点

您可以复制流式端点 URL 并使用它来配置您的忠诚度应用程序以将数据流式传输到 Adobe Experience Platform 忠诚度数据集中。

请参阅 使用用户界面创建HTTP API流连接 有关更全面的教程的解释:

  • 如何使用身份验证,
  • 当传入数据与XDM架构不兼容时如何映射数据,以及
  • 如何在设置流连接器过程中创建数据集。

设置连接

要在 Customer Journey Analytics 中使用 Adobe Experience Platform 数据,您需要创建一个连接,其中包含因设置模式、数据集和工作流所产生的数据。

通过创建连接,您可以将 Adobe Experience Platform 中的数据集集成到工作区中。要报告这些数据集,您必须首先在Adobe Experience Platform和工作区中的数据集之间建立连接。

创建您的连接:

  1. 在 Customer Journey Analytics UI 中,选择顶部导航中的​ 连接

  2. 选择​ 创建新连接

  3. 在无标题连接屏幕中:

    在连接设置中命名并描述您的连接。

    从数据设置中的沙盒列表中选择正确的沙盒,并从平均每日事件数列表中选定每日事件数。

    连接设置

    选择​ 添加数据集

    在添加数据集的选择数据集步骤中:

    • 选择先前(Example Loyalty Dataset)创建的数据集以及要包含在连接中的任何其他数据集。

      添加数据集

    • 选择​ 下一步

    在添加数据集的设置数据集步骤中:

    • 对于每个数据集:

      • 在 Adobe Experience Platform 中,从在数据集模式中定义的可用身份中选择人员 ID。

      • 从数据源类型列表中选择正确的数据源。如果指定​ 其他,则为您的数据源添加描述。

      • 根据您的首选项设置​ 导入所有新数据 ​和​ 数据集回填现有数据

      配置数据集

    • 选择​ 添加数据集

    选择​ 保存

有关如何创建和管理连接以及如何选择和组合数据集的更多信息请参阅连接概述

设置数据视图

数据视图是 Customer Journey Analytics 专属的容器,通过它,可决定如何解释来自连接的数据。 它指定所有可在 Analysis Workspace 中找到的维度和量度,以及这些维度和量度从哪些列获取其数据。为准备 Analysis Workspace 中的报告而定义数据视图。

创建您的数据视图:

  1. 在 Customer Journey Analytics UI 中,选择顶部导航中的​ 数据视图

  2. 选择​ 创建新数据视图

  3. 在配置步骤中:

    从连接列表中选择您的连接。

    名称并(可选)描述您的连接。

    数据视图配置

    选择​ 保存并继续

  4. 在组件步骤中:

    将要包含的任何模式字段和/或标准组件添加到量度或维度组件框中。

    数据视图组件

    选择​ 保存并继续

  5. 在设置步骤中:

    数据视图设置

    保持设置不变并选择​ 保存并完成

请参阅数据视图概述,了解有关如何创建和编辑数据视图、哪些组件可供您在数据视图中使用以及如何使用过滤器和会话的更多信息设置。

设置项目

Analysis Workspace 是一个灵活的浏览器工具,允许您快速构建分析并基于数据共享见解。您可以使用工作区项目来组合数据组件、表和可视化,以制作分析并与组织中的任何人共享。

要创建您的项目:

  1. 在 Customer Journey Analytics UI 中,选择顶部导航中的​ 项目

  2. 选择左侧导航中的​ 项目

  3. 选择​ 创建项目

    工作区项目

    选择​ 空白项目

    工作区 – 空白项目

  4. 从列表中选择您的数据视图。

    工作区选择数据视图

  5. 要创建您的第一个报表,请开始将维度和量度拖放到 自由格式表 在 面板 . 例如,拖动 Program Points Balance 以及 Page View 作为量度和 email 作为维度,以快速查看访问过您的网站并已加入忠诚度计划收集忠诚度点的个人资料。

    工作区 – 第一份报告

请参阅 Analysis Workspace 概述,了解有关如何使用组件、可视化和面板创建项目和构建分析的更多信息。

SUCCESS
您已完成所有步骤。从定义要收集的忠诚度数据(模式)Adobe Experience Platform 中存储忠诚度数据的位置(数据集)开始,您配置了一个 HTTP API 源连接器,以将忠诚度数据直接流到数据集中。您的数据视图定义允许您指定要使用的维度和量度,最后您创建了您的第一个项目来可视化和分析您的数据。
recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79