创建数据元素

CAUTION
我们预计于2024年3月15日星期五发布对本教程的主要更改。 之后,许多练习都将发生更改,您可能需要从头开始重新启动教程才能完成所有课程。

了解如何使用Experience PlatformWeb SDK创建捕获数据所需的基本数据元素。 在上捕获内容和身份数据 Luma演示站点. 了解如何使用您之前创建的XDM架构,通过名为XDM对象的新数据元素类型使用Platform Web SDK收集数据。

NOTE
出于演示目的,本课程中的练习以期间使用的示例为基础, 配置架构 步骤;创建示例XDM对象,用于捕获在上查看的内容和用户的身份 Luma演示站点.
IMPORTANT
本课程的数据来自 digitalData Luma网站的数据层。 要查看数据层,请打开您的开发人员控制台并键入 digitalData 以查看完整的数据层。 digitalData数据层

无论Platform Web SDK如何,您都必须继续在标记属性中创建映射到网站中的数据收集变量的数据元素,例如数据层、HTML属性或其他属性。 创建这些数据元素后,必须将其映射到您在迁移期间创建的XDM架构。 配置架构 上课。 为此,Platform Web SDK扩展提供了一个名为XDM对象的新数据元素类型。 因此,创建数据元素包含两个操作:

  1. 将网站变量映射到数据元素,以及
  2. 将这些数据元素映射到XDM对象

对于步骤1,继续像当前一样使用任何核心标记扩展的数据元素类型将数据层映射到数据元素。 对于步骤2,Platform Web SDK扩展将创建一组之前不可用的新数据元素类型:

  • 事件合并Id
  • 标识映射
  • XDM对象

本课程重点介绍XDM对象和身份映射数据元素类型。 您将创建XDM对象以捕获Luma访客的活动和身份验证状态。

学习目标

在本课程结束时,您能够:

  • 创建数据元素以捕获内容和用户登录ID数据
  • 创建身份映射数据元素
  • 将数据元素映射到XDM对象数据元素

先决条件

您已了解数据层是什么,对 Luma演示站点 数据层,并了解如何引用标记中的数据元素。 您必须在教程中完成以下之前的步骤

IMPORTANT
Experience CloudID服务扩展 在实施Adobe Experience Platform Web SDK时不需要使用,因为ID服务功能已内置到Platform Web SDK中。

创建数据元素以捕获数据层

在开始创建XDM对象之前,请创建以下一组映射到的数据元素 Luma演示站点 数据层:

  1. 转到 数据元素 并选择 添加数据元素 (或 创建新数据元素 如果标记属性中没有现有的数据元素)

    创建数据元素

  2. 将数据元素命名为 page.pageInfo.pageName

  3. 使用 JavaScript变量 数据元素类型 指向Luma数据层中的值: digitalData.page.pageInfo.pageName

  4. 选中复选框 强制使用小写值清除文本 标准化大小写并删除无关空格

  5. 离开 None 作为 存储持续时间 设置,因为该值在每个页面上都不相同

  6. 选择 保存

    Page Name数据元素

按照相同的步骤创建这四个附加数据元素:

  • page.pageInfo.server 已映射到
    digitalData.page.pageInfo.server

  • page.pageInfo.hierarchie1 已映射到
    digitalData.page.pageInfo.hierarchie1

  • user.profile.attributes.username 已映射到
    digitalData.user.0.profile.0.attributes.username

  • user.profile.attributes.loggedIn 已映射到
    digitalData.user.0.profile.0.attributes.loggedIn

  • cart.orderId 已映射到 digitalData.cart.orderId (您将在以下时段使用此插件: 设置Analytics 课程)

CAUTION
此 JavaScript变量 数据元素类型将数组引用视为圆点而不是方括号,因此引用username数据元素为 digitalData.user[0].profile[0].attributes.username 不起作用.

创建身份映射数据元素

接下来,您可以创建Identity Map数据元素:

  1. 转到 数据元素 并选择 添加数据元素

  2. 名称 数据元素 identityMap.loginID

  3. 作为 扩展名,选择 Adobe Experience Platform Web SDK

  4. 作为 数据元素类型,选择 Identity map

  5. 这会提示右侧的 数据收集界面 用于配置标识:

    数据收集界面

  6. 作为 命名空间,选择 Luma CRM Id 您之前在中创建的命名空间 配置身份 上课。

    note note
    NOTE
    如果您没有看到 Luma CRM Id 命名空间,请确认您还在默认的生产沙盒中创建了该命名空间。 目前,仅在默认生产沙盒中创建的命名空间才会显示在命名空间下拉列表中。
  7. 命名空间 ,则必须设置ID。 选择 user.profile.attributes.username 在本课程前面创建的数据元素,会在用户登录Luma网站时捕获ID。

  8. 作为 已验证状态,选择 已验证

  9. 选择 主要

  10. 选择 保存

    数据收集界面

TIP
Adobe建议发送代表个人的身份,例如 Luma CRM Id,作为 主要 身份。
如果身份映射包含人员标识符(例如, Luma CRM Id),则人员标识符将变为 主要 身份。 否则, ECID 变为 主要 身份。

将数据元素映射到XDM对象

您创建的所有数据元素必须映射到XDM对象。 此对象应符合您在以下期间创建的XDM架构: 配置架构 上课。

有不同的方法可以将数据元素映射到XDM对象字段。 您可以将单个数据元素映射到单个XDM字段,也可以将数据元素映射到整个XDM对象,前提是数据元素与XDM对象中存在的精确键值对架构匹配。 在本课程中,您将通过映射到各个字段来捕获内容数据。 您将学习如何 将数据元素映射到整个XDM对象设置Analytics 上课。

创建XDM对象以捕获内容数据:

  1. 在左侧导航中,选择 数据元素

  2. 选择 添加数据元素

  3. 名称 数据元素 xdm.content

  4. 作为 扩展名 选择 Adobe Experience Platform Web SDK

  5. 作为 数据元素类型 选择 XDM object

  6. 选择平台 沙盒 ,您在此期间在中创建了XDM架构: 配置XDM架构 课程,在本例中 DEVELOPMENT Mobile and Web SDK Courses

  7. 作为 架构,选择您的 Luma Web Event Data 架构:

    XDM对象

    note note
    NOTE
    沙盒对应于您在其中创建架构的Experience Platform沙盒。 您的Experience Platform实例中可能有多个沙盒,因此请确保选择正确的沙盒。 始终先进行开发,然后进行生产。
  8. 向下滚动,直到达到 web 对象

  9. 选择以将其打开

    Web对象

  10. 将以下Web XDM变量映射到数据元素

    • web.webPageDetials.name%page.pageInfo.pageName%
    • web.webPageDetials.server%page.pageInfo.server%
    • web.webPageDetials.siteSection%page.pageInfo.hierarchie1%

    XDM对象

  11. 接下来,查找 identityMap 对象并将其选定

  12. 将映射到 identityMap.loginID 数据元素

  13. 选择 保存

    数据收集界面

在这些步骤结束时,您应该创建以下数据元素:

核心扩展数据元素
Platform Web SDK数据元素
cart.orderId
identityMap.loginID
page.pageInfo.hierarchie1
xdm.content
page.pageInfo.pageName
page.pageInfo.server
user.profile.attributes.loggedIn
user.profile.attributes.username

设置这些数据元素后,您即可在标记中创建规则,开始通过XDM对象向Platform Edge Network发送数据。

下一步:

NOTE
感谢您投入时间学习Adobe Experience Platform Web SDK。 如果您有疑问、希望分享一般反馈或有关于未来内容的建议,请在此共享它们 Experience League社区讨论帖子
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4