将示例数据导入到 Adobe Experience Platform

上次更新: 2023-07-26
  • 主题:
  • API
    查看有关此主题的更多信息
  • 创建对象:
  • Experienced
    Developer

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

示例数据用例

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

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

注意

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

先决条件

  • 您有权访问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.jsonluma-inventory-events.json、和 luma-web-events.json 在文本编辑器中并更新所有时间戳,以便事件在上个月发生(例如,搜索 "timestamp":"2022-11 并替换年和月)

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

    注意

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

    Mac文件路径

    注意

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

    Windows文件路径

  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_KEYClient ID 在Adobe Developer控制台中
    • SCOPES
    • TECHNICAL_ACCOUNT_ID
    • IMS
    • IMS_ORGOrganization 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 个人资料
小贴士

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

打开用户档案

浏览 属性活动 选项卡中,您应该会看到配置文件包含来自各种数据文件的数据:
离线购买事件文件中的事件数据

后续步骤

如果您想了解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 文件,用于查看配置文件片段与本教程中上传的数据合并的情况。

重置沙盒环境

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

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

在此页面上