将示例数据导入Adobe Experience Platform

Last update: Fri Jul 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
API

创建对象：

有经验的
开发人员

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

示例数据用例

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

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

NOTE

本教程的最终结果是一个沙盒，其中包含与面向数据架构师和数据工程师的Adobe Experience Platform快速入门教程类似的数据。它于2023年4月更新，以支持Journey Optimizer挑战。它于2023年6月更新，以将身份验证方法切换到OAuth。

先决条件

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

使用Postman postman

设置环境变量

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

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

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

从下载文件夹中，将 platform-utils-main.zip 文件移动到计算机上的所需位置，然后将其解压缩。
在luma-data文件夹中，在文本编辑器中打开所有json文件，并将_yourTenantId的所有实例替换为您自己的租户ID，前面加下划线。
在文本编辑器中打开luma-offline-purchases.json、luma-inventory-events.json和luma-web-events.json并更新所有时间戳，以便事件在上个月发生（例如，搜索"timestamp":"2022-11并替换年和月）

在设置FILE_PATH Postman环境变量时，请注意解压缩文件夹的位置：

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

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

打开Postman并从 工作区 下拉菜单创建工作区：
为您的工作区输入 Name 和可选的 Summary，然后单击 创建Workspace。创建新工作区时，Postman将切换到该工作区。
现在调整一些设置以在此工作区中运行Postman收藏集。在Postman的标题中，单击齿轮图标并选择设置以打开设置模式窗口。您还可以使用键盘快捷键(CMD/CTRL + ，)打开相应模式。

在General选项卡下，将请求超时时间（毫秒）更新为5000 ms并启用allow reading file outside this directory

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

关闭设置面板。
选择环境，然后选择导入：
导入下载的json环境文件DataInExperiencePlatform.postman_environment
在Postman中，从右上角的下拉列表中选择您的环境，然后单击眼睛图标以查看环境变量：
确保填充了以下环境变量。要了解如何获取环境变量的值，请查看对Experience Platform API进行身份验证教程以了解分步说明。
- CLIENT_SECRET
- Adobe Developer Console中的API_KEY—Client ID
- SCOPES
- TECHNICAL_ACCOUNT_ID
- IMS
- Adobe Developer Console中的IMS_ORG—Organization ID
- SANDBOX_NAME
- TENANT_ID — 请确保以下划线开头，例如_techmarketingdemos
- CONTAINER_ID
- platform_end_point
- FILE_PATH — 使用您解压缩platform-utils-main.zip文件的本地文件夹路径。请确保它包含文件夹名称，例如/Users/dwright/Desktop/platform-utils-main
保存更新的环境

导入Postman收藏集

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

选择 收藏集，然后选择导入选项：
导入以下收藏集：
- 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不存储此私钥，但绝不应该与任何人共享生产密钥。

打开0-Authentication收藏集，选择OAuth: Request Access Token请求，然后单击SEND进行身份验证并获取访问令牌。
查看环境变量，并注意ACCESS_TOKEN现已填充。

导入数据

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

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

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

收藏集导入

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

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

如果一切进展顺利，Luma-Loyalty-Data集合中的所有请求都应通过。
现在，让我们登录到Adobe Experience Platform界面并导航到数据集。
打开Luma Loyalty Dataset数据集，然后在数据集活动窗口下，您可以查看摄取1000条记录的成功批处理运行。您还可以单击预览数据集选项以验证摄取的记录。您可能需要等待几分钟，以确认已创建1000个新配置文件片段。
重复步骤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类，包含自定义身份和Commerce详细信息字段组。
- 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界面中：

转到 配置文件 > 浏览
选择Luma Loyalty Id作为 身份命名空间
搜索5625458作为 标识值
打开Daniel Wright配置文件

TIP

如果您没有看到配置文件，请检查数据集页面，以确认所有数据集都已成功创建和摄取数据。如果这样看起来不错，请等待15分钟，然后查看查看查看器中是否提供了配置文件。如果数据摄取存在问题，请检查错误消息以尝试找到问题。您还可以尝试在数据集页面上启用错误诊断，并拖放json数据文件以重新摄取数据。

打开用户档案

通过浏览属性和事件选项卡中的数据，您应该会看到配置文件包含来自各种数据文件的数据：
来自离线购买事件文件的事件数据

后续步骤

如果您想了解Adobe Journey Optimizer，此沙盒包含您进行Journey Optimizer挑战所需的一切

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

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

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

重置沙盒环境 reset-sandbox

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

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

recommendation-more-help

9051d869-e959-46c8-8c52-f0759cee3763