将示例数据导入Adobe Experience Platform
了解如何使用示例数据设置 Experience Platform 沙盒环境。使用 Postman 集合,您可以创建字段组、架构和数据集,然后将示例数据导入 Experience Platform。
示例数据用例
Experience Platform业务用户通常必须完成一系列步骤,包括识别字段组、创建架构、准备数据、创建数据集,然后摄取数据,然后才能探索Experience Platform提供的营销功能。 本教程会自动执行某些步骤,以便您可以尽快将数据导入Platform沙盒。
本教程重点介绍一个名为Luma的虚构零售品牌。 他们投资于Adobe Experience Platform,以将忠诚度、CRM、产品目录和离线购买数据组合到实时客户配置文件中,并激活这些配置文件以将他们的营销提升到新的水平。 我们已为Luma生成了示例数据,在本教程的其余部分中,您将将此数据导入您的某个Experience Platform沙盒环境中。
先决条件
使用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 PlatformAPI进行身份验证教程以了解分步说明。
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
配置文件
通过浏览 属性 和 事件 选项卡中的数据,您应该会看到配置文件包含来自各种数据文件的数据:
来自离线购买事件文件的
后续步骤
如果您想了解Adobe Journey Optimizer,此沙盒包含您进行Journey Optimizer挑战所需的一切
如果您想了解合并策略、数据管理、查询服务和区段生成器,请跳转到数据架构师和数据工程师快速入门教程🔗中的第11课。 本其他教程的前面课程让您手动构建这些Postman收藏集刚刚填充的所有内容 — 祝您一切顺利!
如果要构建示例Web SDK实施以链接到此沙盒,请查看
使用Web SDK实施Adobe Experience Cloud教程。 设置Web SDK教程的“初始配置”、“标记配置”和“设置Experience Platform”课程后,使用密码test
登录Luma网站(使用luma-crm.json
文件中的前10个电子邮件地址),查看配置文件片段与本教程中上传的数据合并的情况。
如果要构建一个链接到此沙盒的示例Mobile SDK实施,请查看
在移动应用程序中实施Adobe Experience Cloud教程。 在设置Web SDK教程的“初始配置”、“应用程序实施”和“Experience Platform”课程后,使用luma-crm.json
文件中的第一个电子邮件地址登录Luma网站,查看配置文件片段与本教程中上传的数据合并的情况。
重置沙盒环境 reset-sandbox
重置非生产沙盒会删除与该沙盒关联的所有资源(架构、数据集等),同时保持沙盒的名称和关联的权限。 对于有权访问此“清理”沙盒的用户,将继续以相同的名称提供该沙盒。
按照此处步骤重置沙盒环境。