将示例数据导入到 Adobe Experience Platform

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

示例数据用例

Experience Platform业务用户通常必须完成一系列步骤，包括识别字段组、创建架构、准备数据、创建数据集，然后摄取数据，然后才能探索Experience Platform提供的营销功能。 本教程会自动执行某些步骤，以便您可以尽快将数据导入Platform沙盒。

本教程重点介绍一个名为Luma的虚构零售品牌。 他们投资于Adobe Experience Platform，以将忠诚度、CRM、产品目录和离线购买数据组合到实时客户配置文件中，并激活这些配置文件以将他们的营销提升到新的水平。 我们已为Luma生成了示例数据，在本教程的其余部分中，您将将此数据导入您的某个Experience Platform沙盒环境中。

先决条件

• 您有权访问Experience PlatformAPI并了解如何进行身份验证。 如果没有，请查看 教程.
• 您有权访问Experience Platform开发沙盒。
• 您知道您的Experience Platform租户ID。 您可以通过进行身份验证来获取它 API请求
  或者通过在您登录Platform帐户时从URL中提取此变量。 例如，在以下URL中，租户是"techmarketingdemos" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home.

使用 Postman

设置环境变量

在执行以下步骤之前，请确保您已下载 Postman 应用程序。 让我们开始吧！

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

   注意

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

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

3. 在 luma-data 文件夹，打开所有 json 文本编辑器中的文件并替换的所有实例 _yourTenantId 您自己的租户id，前面有下划线。

4. 打开 luma-offline-purchases.json， luma-inventory-events.json、和 luma-web-events.json 在文本编辑器中并更新所有时间戳，以便事件在上个月发生(例如，搜索 "timestamp":"2022-11 并替换年和月)

5. 请注意解压缩文件夹的位置，以便您以后在设置 FILE_PATH Postman 环境变量：

   注意

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

   

   注意

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

   

6. 打开 Postman 并从创建工作区 工作区 下拉菜单：
   

7. 输入 名称 和可选 摘要 （对于工作区），然后单击 创建工作区. Postman 将在您创建新工作区时切换到它。
   

8. 现在调整一些设置以运行 Postman 此工作区中的收藏集。 在的标题中 Postman，单击齿轮图标并选择 设置 以打开设置模式窗口。 您还可以使用键盘快捷键(CMD/CTRL + ，)打开相应模式。

9. 在 General 选项卡，将请求超时更新为 5000 ms 并启用 allow reading file outside this directory
   

   注意

   如果文件是从工作目录中加载的，则当相同的文件存储在其他设备上时，它将跨设备平稳运行。 但是，如果您希望从工作目录外部运行文件，则必须打开设置以表示相同的意图。 如果您的 FILE_PATH 与 Postman的工作目录路径，则应启用此选项。

10. 关闭 设置 面板。

11. 选择 环境 然后选择 导入：
    

12. 导入下载的json环境文件， DataInExperiencePlatform.postman_environment

13. 在Postman中，从右上角的下拉列表中选择您的环境，然后单击眼睛图标以查看环境变量：
    

14. 确保填充了以下环境变量。 要了解如何获取环境变量的值，请查看 对Experience PlatformAPI进行身份验证 有关分步说明的教程。

    • CLIENT_SECRET
    • API_KEY—Client ID 在Adobe Developer控制台中
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORG—Organization ID 在Adobe Developer控制台中
    • SANDBOX_NAME
    • TENANT_ID — 确保以下划线开头，例如 _techmarketingdemos
    • CONTAINER_ID
    • platform_end_point
    • FILE_PATH — 使用解压缩后的本地文件夹路径 platform-utils-main.zip 文件。 请确保其中包含文件夹名称，例如 /Users/dwright/Desktop/platform-utils-main

15. 保存 更新的环境

导入Postman收藏集

接下来，您需要将收藏集导入Postman。

1. 选择 收藏集 然后选择导入选项：

   

2. 导入以下收藏集：

   • 0-Authentication.postman_collection.json
   • 1-Luma-Loyalty-Data.postman_collection.json
   • 2-Luma-CRM-Data.postman_collection.json
   • 3-Luma-Product-Catalog.postman_collection.json
   • 4-Luma-Offline-Purchase-Events.postman_collection.json
   • 5-Luma-Product-Inventory-Events.postman_collection.json
   • 6-Luma-Test-Profiles.postman_collection.json
   • 7-Luma-Web-Events.postman_collection.json

   

身份验证

接下来，您需要进行身份验证并生成用户令牌。 请注意，本教程中使用的令牌生成方法仅适用于非生产用途。 本地签名从第三方主机加载JavaScript库，而远程签名将私钥发送到Adobe拥有并运行的Web服务。 虽然Adobe不会存储此私钥，但绝不应该与任何人共享生产密钥。

1. 打开 0-Authentication 收藏集，选择 OAuth: Request Access Token 请求，然后单击 SEND 验证并获取访问令牌。

   

2. 查看环境变量，并注意 ACCESS_TOKEN 现已填充。

导入数据

现在，您可以准备数据并将其导入Platform沙盒。 您导入的Postman系列将完成所有繁重的工作！

1. 打开 1-Luma-Loyalty-Data 收藏集并单击 运行 在“概述”选项卡上启动集合运行器。

   

2. 在集合运行程序窗口中，确保从下拉列表中选择环境，然后更新 延迟 到 4000ms，查看 保存响应 选项，并确保运行顺序正确。 单击 运行Luma忠诚度数据 按钮

   

   注意

   1-Luma-Loyalty-Data 为客户忠诚度数据创建架构。 该架构基于XDM Individual Profile类、标准字段组以及自定义字段组和数据类型。 该收藏集使用架构创建数据集，并将示例客户忠诚度数据上传到Adobe Experience Platform。

   注意

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

3. 如果一切顺利，则中的所有请求 Luma-Loyalty-Data 收藏集应通过。

   

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

5. 打开 Luma Loyalty Dataset 在数据集活动窗口下，您可以查看摄取1000条记录的成功批量运行。 您还可以单击预览数据集选项以验证摄取的记录。 您可能需要等待几分钟来确认1000 新建配置文件片段 创建。
   

6. 重复步骤1 - 3以运行其他收藏集：

   • 2-Luma-CRM-Data.postman_collection.json 为客户的CRM数据创建架构和填充的数据集。 架构基于XDM个人配置文件类，此类包含人口统计详细信息、个人联系详细信息、首选项详细信息和自定义身份字段组。
   • 3-Luma-Product-Catalog.postman_collection.json 为产品目录信息创建架构和填充的数据集。 该架构基于自定义产品目录类，并使用自定义产品目录字段组。
   • 4-Luma-Offline-Purchase-Events.postman_collection.json 为客户离线购买事件数据创建架构并填充数据集。 该架构基于XDM ExperienceEvent类，包含自定义身份和商务详细信息字段组。
   • 5-Luma-Product-Inventory-Events.postman_collection.json 为与进货和缺货产品相关的事件创建架构并填充数据集。 架构基于自定义业务事件类和自定义字段组。
   • 6-Luma-Test-Profiles.postman_collection.json 创建架构并填充包含要在Adobe Journey Optimizer中使用的测试配置文件的数据集
   • 7-Luma-Web-Events.postman_collection.json 使用简单的历史Web数据创建一个架构和填充的数据集。

验证

经过设计，可在集合运行时，构建可组合来自多个系统的数据的实时客户档案。 忠诚度、CRM和离线购买数据集的第一个记录就是一个很好的例子。 查找该配置文件以确认数据已摄取。 在 Adobe Experience Platform界面：

1. 转到 配置文件 > 浏览
2. 选择 Luma Loyalty Id 作为 身份命名空间
3. 搜索 5625458 作为 标识值
4. 打开 Daniel Wright 个人资料

浏览 属性 和 活动 选项卡中，您应该会看到配置文件包含来自各种数据文件的数据：

后续步骤

如果您想了解Adobe Journey Optimizer，此沙盒包含您需要采用的 Journey Optimizer挑战

如果您想了解合并策略、数据管理、查询服务和区段生成器，请跳转到 数据架构师和数据工程师快速入门教程中的第11课. 本其他教程的前面课程让您手动构建这些Postman收藏集刚刚填充的所有内容 — 祝您一切顺利！

如果要构建示例Web SDK实施以链接到此沙盒，请查看
使用Web SDK实施Adobe Experience Cloud教程. 在Web SDK教程中设置了“初始配置”、“标记配置”和“设置Experience Platform”课程后，使用中的前十个电子邮件地址登录Luma网站 luma-crm.json 使用密码的文件 test 查看配置文件片段与本教程中上传的数据合并的情况。

如果要构建一个链接到此沙盒的示例Mobile SDK实施，请查看
在移动应用程序中实施Adobe Experience Cloud教程. 在设置Web SDK教程的“初始配置”、“应用程序实施”和“Experience Platform”课程后，使用中的第一个电子邮件地址登录Luma网站 luma-crm.json 文件，用于查看配置文件片段与本教程中上传的数据合并的情况。

重置沙盒环境

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

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