了解如何使用一些示例数据设置Experience Platform沙盒环境。 使用邮递员收集,您可以创建字段组、架构、数据集,然后将示例数据导入Experience Platform。
Experience Platform业务用户通常必须完成一系列步骤,包括确定字段组、创建模式、准备数据、创建数据集,然后摄取数据,然后才能探索Experience Platform提供的某些功能。 在本教程中,您可以找到一种轻松的方法来自动执行一些步骤并尽快在Platform中获取数据。
本教程重点介绍一个虚构的零售品牌Luma。 Luma在多个国家/地区经营实体店,并拥有一个网站和移动应用的在线存放。 他们投资于Adobe Experience Platform以将忠诚度、CRM、Web和离线购买数据合并到实时客户档案中,并激活这些档案以提升其营销水平。 我们为Luma生成了示例数据,在下一部分中,您可以了解如何将数据导入Experience Platform。
要完成本教程,您可以使用 Postman应用程序的UI 或使用命令行 邮递员(Newman)的收藏员
techmarketingdemos
" https://experience.adobe.com/#/@techmarketingdemos/sname:prod/platform/home
. 您还可以通过进行身份验证来获取该域 API请求.在执行这些步骤之前,请确保已下载 邮递员 应用程序,并且有权访问Experience PlatformAPI。 在本教程中,我们将使用沙盒环境。 它提供了一个孤立的环境,您无需将资源和数据与生产环境混合即可在其中试用功能。 我们开始吧。
包含在 platform-utils-main.zip 文件是虚构的,仅用于演示目的。
下载 platform-utils-main.zip 文件,其中包含本教程所需的所有文件。
从下载文件夹中,移动 platform-utils-main.zip
文件到计算机上的所需位置,然后将其解压缩。
请注意解压缩文件的位置,因为我们稍后在设置 FILE_PATH
postman环境变量
要在Mac上获取文件路径,请导航到 platform-utils-main
文件夹,右键单击文件夹并选择 获取信息 选项。
要在窗口上获取文件路径,请单击以打开所需文件夹的位置,然后在地址栏中右键单击路径的右侧。 复制地址以获取文件路径。
启动邮件管理并创建新工作区。 复制 where
元数据值
要创建新工作区,请使用 工作区 Postman左侧的下拉菜单。 您可以选择现有工作区或为项目创建新工作区。
输入 名称 可选 概要 ,请单击 创建工作区. Postman将在您创建新工作区时切换到该工作区。
现在,让我们执行一些其他设置,以在此工作区中运行我们的邮递员收藏集。 在Postman标题中,单击扳手图标,然后选择 设置 以打开设置模式窗口。 您还可以使用键盘快捷键(CMD/CTRL + 、)打开模式窗口。
在 General
选项卡,让我们在ms到中更新请求超时 5000 ms
启用 allow reading file outside this directory
如果文件是从工作目录中加载的,则如果同一文件存储在其他设备上,则文件将跨设备顺利运行。 但是,如果希望从外部工作目录运行文件,则必须打开设置以声明相同的意图。 如果 FILE_PATH
与postman的工作目录路径不同,则应启用此选项。
关闭设置面板。
选择环境选项,然后单击导入选项。
让我们导入下载的json环境文件, DataInExperiencePlatform.postman_environment
,然后单击 导入
在Postman中,从右上方的下拉菜单中选择您的环境,然后单击眼睛图标以查看环境变量。
确保填充以下环境变量。 要了解如何获取环境变量的值,请查看 验证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
更新 FILE_PATH
变量到您解压缩的本地文件夹路径 platform-utils-main.zip
文件。 您可以编辑变量,方法是从左侧的“环境”中打开一个环境,或者打开Postman右上方的环境快速查看(眼睛按钮),然后单击“编辑”。
现在,我们需要填充以下环境变量的值。 为此,我们需要将收藏集文件上传到我们的工作区。
JWT_TOKEN
ACCESS_TOKEN
选择收藏集,然后选择导入选项
将以下集合文件导入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
打开 Authentication
收藏集,选择 IMS: JWT Generate + Auth via User Token
POST请求,然后单击 SEND
验证并获取访问令牌。
查看环境变量,您会注意到 JWT_TOKEN
和 ACCESS_TOKEN
现已填充。
在 luma-data
文件夹,打开所有 json
文件,并替换所有实例 _techmarketingdemos
使用您自己的租户id,前面有一个下划线。
打开 Luma-Loyalty-Data
收藏集,单击 运行 在“概述”选项卡上,启动“收藏集运行者”。
在收集运行程序窗口中,确保从下拉列表中选择环境,提供4000毫秒的延迟,选中保存响应选项,并确保运行顺序正确。 单击 运行Luma忠诚度数据 按钮
Luma-Loyaty-Data 收集运行将创建一个架构以包含客户忠诚度数据。 此架构基于XDM Indivilue Profile类,该类包含自定义字段组和数据类型。 收藏集还使用架构创建数据集,并将示例客户忠诚度数据上传到Adobe Experience Platform。
如果在postman收集运行程序期间有任何收集请求失败,请停止执行并逐一运行收集请求。
如果一切顺利, Luma-Loyalty-Data
收藏集应通过。
现在,让我们登录 Adobe Experience Platform UI 和导航到数据集。
打开 Luma Loyalty Dataset
数据集,然后在“数据集活动”窗口下,您可以查看成功的批量运行,该运行已摄取1000条记录。 您还可以单击预览数据集选项以验证摄取的记录。
重复步骤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。在执行这些步骤之前,请确保您有权访问Experience PlatformAPI。 在本教程中,我们将使用沙盒环境,因为它提供了一个孤立的环境,您无需将资源和数据与生产环境混合即可在其中试用功能。
要运行Newman,请确保您拥有Node.js >= v10。 通过包管理器安装Node.js.
运行命令 node -v
以确保已安装节点。
安装Newman最简单的方法是使用NPM。 如果您安装了Node.js,则很可能您也安装了NPM。
按照步骤操作 此处 为系统安装newman
运行命令 newman -v
来确保纽曼的安装。
下载 platform-utils-main.zip 文件,其中包含本教程所需的所有文件。
从下载文件夹中,移动 platform-utils-main.zip
文件到计算机上的所需位置,然后将其解压缩。
请注意解压缩文件的位置,因为我们稍后在设置 FILE_PATH
postman环境变量
打开 platform-utils-main
文件夹。
运行 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
如果一切顺利, Luma-Loyalty-Data
收藏集应通过。
现在,让我们登录 Adobe Experience Platform UI 和导航到数据集。
打开 Luma Loyalty Dataset
数据集,然后在“数据集活动”窗口下,您可以查看成功的批量运行,该运行已摄取1000条记录。 您还可以单击预览数据集选项以验证摄取的记录。
重复步骤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
重置非生产沙盒会删除与该沙盒(架构、数据集等)关联的所有资源,同时维护沙盒的名称和关联的权限。 对于有权访问该“干净”沙盒的用户,该沙盒将继续以相同的名称提供。
按照步骤操作 此处 重置沙盒环境。