通过Adobe Experience Platform Edge Network服务器API引入数据

本快速入门指南介绍如何使用Adobe Experience Platform Edge Network Server API和Edge Network将跟踪数据从物联网设备、机顶盒、游戏控制台和桌面应用程序等设备直接摄取到Adobe Experience Platform中。 然后将这些数据用于Customer Journey Analytics。

要完成此操作，您必须：

• 在 Adobe Experience Platform 中​设置模式和数据集 ，以定义要收集的数据的模型（模式）以及实际收集数据的位置（数据集）。

• 设置数据流 以配置 Adobe Experience Platform Edge Network，将您收集的数据路由到您在 Adobe Experience Platform 中配置的数据集。

• 使用服务器API 将数据直接从桌面、游戏机、物联网设备或机顶盒上运行的应用程序或游戏发送到数据流。

• 部署和验证。拥有一个可在其中进行迭代开发的环境，一旦一切通过验证，就将其实时发布到生产环境中。

• 在 Customer Journey Analytics 中​设置连接。此连接应（至少）包含 Adobe Experience Platform 数据集。

• 在 Customer Journey Analytics 中​设置数据视图​以定义要在 Analysis Workspace 中使用的量度和维度。

• 在 Customer Journey Analytics 中​设置一个项目​以构建报告和可视化图表。

设置模式和数据集

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

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

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

设置模式

您希望跟踪在主机上玩游戏的配置文件中的某些最小数据，例如标识、分数、进度和其他信息。
您必须首先定义一个模式来模拟此数据。

设置您的模式：

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

2. 选择 创建架构…

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

   1. 选择 体验事件.

      

      信息提示

      Experience Event架构用于为 行为 配置文件（如场景名称、要添加到购物车的按钮）的。 个人配置档案模式用于对个人配置档案​_属性_（如姓名、电子邮件、性别）建模。

   2. 选择​下一步。

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

   1. 输入 架构显示名称 （可选）a 描述.

      

   2. 选择​完成。

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

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

      

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

   2. 在 添加字段组 对话框，选择 闪光灯 列表中的字段组。 创建此字段组是为了跟踪用户在主机上玩名为Blinding Light的虚构游戏的进度。

      

      您可以选择预览按钮，以查看属于该字段组的字段的预览，例如 scores > afterMatch。

      

      选择​返回​关闭预览。

   3. 选择​添加字段组。

6. 选择 + 位于您的架构名称旁边。

   

7. 在 字段属性 面板，输入 identification 作为 字段名称， 标识 作为 显示名称，选择 对象 作为 类型 并选择 ExperienceEvent Core v2.1 作为 字段组.

   

   标识对象将标识功能添加到架构中。 对于您的情况，您需要使用用户用于登录到游戏主机的Experience CloudID和电子邮件地址来识别正在玩游戏的用户档案。 有许多其他属性可用于跟踪您的人员身份。

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

8. 选择刚刚添加的标识对象中的​ecid​字段，选择​标识​和​主要标识 和 ECID 来自右侧面板中的 标识命名空间 列表。

   

   您将 Experience Cloud Identity 指定为 Adobe Experience Platform Identity 服务可用于组合（缝合）具有相同 ECID 的配置文件行为的主要身份。

   选择 应用。您会看到 ecid 属性中出现指纹图标。

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

   

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

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

   选择​保存。

10. 选择显示模式名称的模式的根元素，然后选择 配置文件 开关。

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

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

    重要

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

    

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

您创建了一个最小架构，用于模拟您可以从游戏中捕获的数据。 该模式允许使用 Experience Cloud Identity 和电子邮件地址来识别配置文件。通过启用配置文件的架构，您可以确保将从控制台游戏中捕获的数据添加到实时客户配置文件中。

除了行为数据之外，您还可以从控制台捕获配置文件属性数据（例如，登录到控制台的配置文件的详细信息）。

要捕获用户档案数据，您应：

• 基于 XDM 个人配置文件类创建模式。

• 将 Profile Core v2 字段组添加到模式中。

• 添加基于 Profile Core v2 字段组的标识对象。

• 将Experience CloudID定义为主标识符，将电子邮件定义为标识符。

• 为配置文件启用模式

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

设置数据集

使用您的模式，您已经定义了数据模型。现在，您必须定义结构以使用数据集存储和管理这些数据。

设置您的数据集

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

2. 选择​创建数据集。

   

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

   。

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

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

   

6. 选择​完成。

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

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

   重要

   只有当数据集所依附的模式也为配置文件启用时，您才能为配置文件启用数据集。

   

有关如何查看、预览、创建和删除数据集的更多信息，请参阅数据集 UI 指南。以及如何为实时客户配置文件启用数据集。

设置数据流

数据流表示在实施Adobe Experience Platform Web SDK和Mobile SDK以及Adobe Experience Platform Edge Network服务器API时的服务器端配置。 使用Adobe Experience Platform SDK和边缘网络服务器API收集数据时，数据会发送到Adobe Experience Platform边缘网络。 它是确定数据转发到哪些服务的数据流。

在设置中，您希望将从游戏中收集的数据发送到Adobe Experience Platform中的数据集。

设置您的数据流

1. 在 Adobe Experience Platform UI 的左边栏中，选择 数据收藏集 中的 数据流。

2. 选择​新数据流。

3. 命名并描述您的数据流。从 事件模式 列表中选择您的模式。

   

4. 选择​保存。

5. 选择 添加服务。

6. 在 添加服务屏幕：

   1. 从 服务 列表中选择 Adobe Experience Platform。

   2. 确保选择 Enabled。

   3. 从 事件数据集 列表中选择您的数据集。

      

   4. 保留其他设置并选择 保存 以保存数据流。

您的数据流现在配置为将从游戏中收集的数据转发到Adobe Experience Platform中的数据集。

有关如何配置数据流和如何处理敏感数据的更多信息，请参阅数据流概述。

使用Edge Network服务器API

在游戏开发中，您可以根据需要向Adobe Experience Platform Edge Network服务器API添加相关调用。

例如，要更新播放器的得分，您将使用：

curl -X POST "https://server.adobedc.net/ee/v2/interact?dataStreamId={DATASTREAM_ID}"
-H "Authorization: Bearer {TOKEN}"
-H "x-gw-ims-org-id: {ORG_ID}"
-H "x-api-key: {API_KEY}"
-H "Content-Type: application/json"
-d '{
   "event": {
      "xdm": {
         "identityMap": {
            "Email_LC_SHA256": [
               {
                  "id": "0c7e6a405862e402eb76a70f8a26fc732d07c32931e9fae9ab1582911d2e8a3b",
                  "primary": true
               }
            ]
         },
         "eventType": "game.scoreUpdate",
         "{sandbox}": {
            "scores": {
               "afterMatch": 132391",
            }
         },
         "timestamp": "2021-08-09T14:09:20.859Z"
      }
   }
}'

在示例POST请求中， {DATASTREAM_ID} 指向您之前配置的示例数据流的标识符。 {sandbox} 是沙盒的唯一名称，用于标识自定义Blinding Light字段组的路径。

请参阅 交互式数据收集 和 非交互式数据收集 有关如何使用Edge Network服务器API的更多信息。

设置连接

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

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

创建您的连接：

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

2. 选择​创建新连接。

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

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

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

   

   选择​添加数据集。

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

   • 选择您之前创建的数据集和/或要包含在连接中的其他相关数据集

   • 选择​下一步。

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

   • 对于每个数据集：

     • 在 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. 要创建您的第一个报表，请开始将维度和量度拖放到 自由格式表 在 面板.

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