将示例数据导入Adobe Experience Platform

了解如何使用一些示例数据设置Experience Platform沙盒环境。 使用邮递员收集，您可以创建字段组、架构、数据集，然后将示例数据导入Experience Platform。

示例数据用例

Experience Platform业务用户通常必须完成一系列步骤，包括确定字段组、创建模式、准备数据、创建数据集，然后摄取数据，然后才能探索Experience Platform提供的某些功能。 在本教程中，您可以找到一种轻松的方法来自动执行一些步骤并尽快在Platform中获取数据。

本教程重点介绍一个虚构的零售品牌Luma。 Luma在多个国家/地区经营实体店，并拥有一个网站和移动应用的在线存放。 他们投资于Adobe Experience Platform以将忠诚度、CRM、Web和离线购买数据合并到实时客户档案中，并激活这些档案以提升其营销水平。 我们为Luma生成了示例数据，在下一部分中，您可以了解如何将数据导入Experience Platform。

要完成本教程，您可以使用Postman应用程序的UI或使用命令行Collection Runner for Postman(Newman)

先决条件

• 您已经过身份验证，并有权访问Experience PlatformAPI。 如果没有，您可以按照此tutorial快速设置它。
• 您有权访问Experience Platform沙盒环境。

使用Postman

导入Postman收藏集并设置环境变量

在执行这些步骤之前，请确保您已下载Postman应用程序并有权访问Experience PlatformAPI。 在本教程中，我们将使用沙盒环境。 它提供了一个孤立的环境，您无需将资源和数据与生产环境混合即可在其中试用功能。 我们开始吧。

1. 下载platform-utils-main.zip文件，其中包含本教程所需的所有文件。

2. 从下载文件夹中，将platform-utils-main.zip文件移动到计算机上的所需位置，然后解压缩该文件。

3. 请记下解压缩文件的位置，因为我们稍后在设置FILE_PATH postman环境变量时可能需要它

   注意

   要获取Mac上的文件路径，请导航到platform-utils-main文件夹，右键单击该文件夹并选择​获取信息​选项。

   

   注意

   要在窗口上获取文件路径，请单击以打开所需文件夹的位置，然后在地址栏中右键单击路径的右侧。 复制地址以获取文件路径。

   

4. 启动邮件管理并创建新工作区。 从where

5. 要创建新工作区，请使用Postman左侧的​Workspaces​下拉菜单。 您可以选择现有工作区或为项目创建新工作区。
   

6. 为工作区输入​名称​和可选​摘要，然后单击​创建工作区。 Postman将在您创建新工作区时切换到该工作区。
   

7. 现在，让我们执行一些其他设置，以在此工作区中运行我们的邮递员收藏集。 在Postman标题中，单击扳手图标，然后选择​Settings​以打开设置模式。 您还可以使用键盘快捷键(CMD/CTRL + 、)打开模式窗口。

8. 在General选项卡下，让我们将请求超时（以毫秒为单位）更新为5000 ms并启用allow reading file outside this directory

   

   注意

   如果文件是从工作目录中加载的，则如果同一文件存储在其他设备上，则文件将跨设备顺利运行。 但是，如果希望从外部工作目录运行文件，则必须打开设置以声明相同的意图。 如果您的FILE_PATH与邮递员的工作目录路径不同，则应启用此选项。

9. 关闭设置面板。

10. 选择环境选项，然后单击导入选项。
    

11. 让我们导入下载的json环境文件DataInExperiencePlatform.postman_environment，然后单击​Import

12. 在Postman中，从右上方的下拉菜单中选择您的环境，然后单击眼睛图标以查看环境变量。
    

13. 确保填充以下环境变量。 要了解如何获取环境变量的值，请参阅Experience PlatformAPI的身份验证教程，以了解分步说明。

    • CLIENT_SECRET
    • API_KEY
    • TECHNICAL_ACCOUNT_ID
    • META_SCOPE
    • IMS
    • IMS_ORG
    • PRIVATE_KEY
    • SANDBOX_NAME
    • CONTAINER_ID
    • TENANT_ID
    • platform_end_point
    • FILE_PATH
    • PRIVATE_KEY

14. 将FILE_PATH变量更新为已解压缩platform-utils-main.zip文件的本地文件夹路径。 您可以编辑变量，方法是从左侧的“环境”中打开一个环境，或者打开Postman右上方的环境快速查看（眼睛按钮），然后单击“编辑”。
    

15. 现在，我们需要填充以下环境变量的值。 为此，我们需要将收藏集文件上传到我们的工作区。

    • JWT_TOKEN
    • ACCESS_TOKEN

16. 选择收藏集，然后选择导入选项

    

17. 将以下集合文件导入Postman

    • Authentication.postman_collection.json
    • Luma-Loyalty-Data.postman_collection.json
    • Luma-CRM-Data.postman_collection.json
    • Luma-Product-Catalog.postman_collection.json
    • Luma-Offline-Purchase-Events.postman_collection.json

    

18. 打开Authentication集合，选择IMS: JWT Generate + Auth via User TokenPOST请求，然后单击SEND以验证并获取访问令牌。

    

19. 查看环境变量，您会注意到JWT_TOKEN和ACCESS_TOKEN现已填充。

20. 打开Luma-Loyalty-Data收藏集，然后单击“概述”选项卡上的​运行​以启动收藏集运行器。

    

21. 在收集运行程序窗口中，确保从下拉列表中选择环境，提供4000毫秒的延迟，选中保存响应选项，并确保运行顺序正确。 单击​运行Luma忠诚度数据​按钮

    

    注意

    Luma-Loyaty-Datacollection运 行将创建一个架构以包含客户忠诚度数据。此架构基于XDM Indivilue Profile类，该类包含自定义字段组和数据类型。 收藏集还使用架构创建数据集，并将示例客户忠诚度数据上传到Adobe Experience Platform。

    注意

    如果在postman收集运行程序期间有任何收集请求失败，请停止执行并逐一运行收集请求。

22. 如果一切正常，Luma-Loyalty-Data集合中的所有请求都应通过。

    

23. 现在，让我们登录到Adobe Experience Platform UI并导航到数据集。

24. 打开Luma Loyalty Dataset数据集，在数据集活动窗口下，您可以查看成功的批量运行，该运行已摄取1000条记录。 您还可以单击预览数据集选项以验证摄取的记录。
    

25. 重复步骤21 - 23以运行以下集合：

    • Luma-CRM-Data.postman_collection.json :收集运行将创建一个架构以包含客户的CRM数据。此架构基于XDM个人用户档案类，该类包含人口统计详细信息、个人联系详细信息和Luma身份用户档案字段组。 收藏集还使用架构创建数据集，并将示例客户CRM数据上传到Adobe Experience Platform。
    • Luma-Product-Catalog.postman_collection.json :收集运行将创建一个包含产品目录信息的架构。架构基于包含产品目录mixin、商务详细信息和消费者体验事件mixin的自定义类。 收藏集还使用架构创建数据集，并将产品数据上传到Adobe Experience Platform。
    • Luma-Offline-Purchase-Events.postman_collection.json:收集运行将创建一个架构以包含客户的离线购买事件数据。此架构基于XDM ExperienceEvent类，包含用于捕获客户忠诚度信息及其离线购买事件的字段组。 收藏集还使用架构创建数据集，并将离线购买事件数据上传到Adobe Experience Platform。

使用Newman

在执行这些步骤之前，请确保您有权访问Experience PlatformAPI。 在本教程中，我们将使用沙盒环境，因为它提供了一个孤立的环境，您无需将资源和数据与生产环境混合即可在其中试用功能。

安装NodeJs和Newman

1. 要运行Newman，请确保您拥有Node.js >= v10。 通过包管理器安装Node.js。

2. 运行命令node -v以确保已安装节点。

3. 安装Newman最简单的方法是使用NPM。 如果您安装了Node.js，则很可能您也安装了NPM。

4. 按照此处的步骤为系统安装newman

5. 运行命令newman -v以确保已安装newman。

6. 下载platform-utils-main.zip文件，其中包含本教程所需的所有文件。

7. 从下载文件夹中，将platform-utils-main.zip文件移动到计算机上的所需位置，然后解压缩该文件。

8. 请记下解压缩文件的位置，因为我们稍后在设置FILE_PATH postman环境变量时可能需要它

9. 在终端窗口中打开platform-utils-main文件夹。

10. 运行Luma-Loyalty-Data.postman_collection.json以构建字段组、架构、数据集，并将样本忠诚度数据摄取到Adobe Experience Platform

    • newman run Luma-Loyalty-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json —insecure --delay-request 4000

11. 如果一切正常，Luma-Loyalty-Data集合中的所有请求都应通过。

12. 现在，让我们登录到Adobe Experience Platform UI并导航到数据集。

13. 打开Luma Loyalty Dataset数据集，在数据集活动窗口下，您可以查看成功的批量运行，该运行已摄取1000条记录。 您还可以单击预览数据集选项以验证摄取的记录。

    

14. 重复步骤10 - 13以运行以下集合：

    • 运行Luma-CRM-Data.postman_collection.json以生成字段组、架构、数据集，并将示例CRM数据摄取到Adobe Experience Platform
      • newman run Luma-CRM-Data.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • 运行Luma-Product-Catalog.postman_collection.json以生成字段组、架构、数据集，并将示例产品数据摄取到Adobe Experience Platform
      • newman run Luma-Product-Catalog.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000
    • 运行Luma-Offline-Purchase-Events.postman_collection.json以生成字段组、架构、数据集，并将示例产品数据摄取到Adobe Experience Platform
      • newman run Luma-Offline-Purchase-Events.postman_collection.json -e DataInExperiencePlatform.postman_environment.json --export-environment DataInExperiencePlatform.postman_environment.json --insecure --delay-request 4000

重置沙盒环境

重置非生产沙盒会删除与该沙盒（架构、数据集等）关联的所有资源，同时维护沙盒的名称和关联的权限。 对于有权访问该“干净”沙盒的用户，该沙盒将继续以相同的名称提供。

按照此处的步骤重置沙盒环境。