将示例数据导入Adobe Experience Platform

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

示例数据用例

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

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

要完成本教程,您可以使用 Postman应用程序的UI 或使用命令行 邮递员(Newman)的收藏员

先决条件

  • 您已经过身份验证,并有权访问Experience PlatformAPI。 如果没有,您可以按照以下步骤快速设置 教程.
  • 您有权访问Experience Platform沙盒环境。
  • 知晓您的Experience Platform租户ID。 当您登录Platform帐户时,您的租户ID应会显示在URL中。 在以下URL中,租户为“techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home. 您还可以通过进行身份验证来获取该域 API请求.

使用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左侧的下拉菜单。 您可以选择现有工作区或为项目创建新工作区。
    创建工作区

  6. 输入 名称 可选 概要 ,请单击 创建工作区. Postman将在您创建新工作区时切换到该工作区。
    保存工作区

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

  8. General 选项卡,让我们在ms到中更新请求超时 5000 ms 启用 allow reading file outside this directory

    设置

    注意

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

  9. 关闭设置面板。

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

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

  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 Token POST请求,然后单击 SEND 验证并获取访问令牌。

    收藏集导入

  19. 查看环境变量,您会注意到 JWT_TOKENACCESS_TOKEN 现已填充。

  20. luma-data 文件夹,打开所有 json 文件,并替换所有实例 _techmarketingdemos 使用您自己的租户id,前面有一个下划线。

  21. 打开 Luma-Loyalty-Data 收藏集,单击 运行 在“概述”选项卡上,启动“收藏集运行者”。

    收藏集导入

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

    收藏集导入

    注意

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

    注意

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

  23. 如果一切顺利, Luma-Loyalty-Data 收藏集应通过。

    忠诚度结果

  24. 现在,让我们登录 Adobe Experience Platform UI 和导航到数据集。

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

  26. 重复步骤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 来确保纽曼的安装。

  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

重置沙盒环境

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

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

在此页面上