将示例数据导入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。 在本教程中,我们将使用沙盒环境。 它提供了一个孤立的环境,您无需将资源和数据与生产环境混合即可在其中试用功能。 我们开始吧。

注意

platform-utils-main.zip文件中包含的用户数据是虚构的,仅用于演示目的。

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

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

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

    注意

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

    Mac文件路径

    注意

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

    Windows文件路径

  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_TOKENACCESS_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

重置沙盒环境

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

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

在此页面上