文档Experience PlatformWeb SDK 教程

使用Adobe Experience Platform Web SDK设置Adobe Analytics

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 初学者
  • 中级
  • 开发人员

了解如何使用Adobe Experience Platform Web SDK设置Adobe Analytics，创建标记规则以将数据发送到Adobe Analytics，并验证Analytics是否按预期捕获数据。

Adobe Analytics是一款行业领先的应用程序，可帮助您了解客户的行为和需求，并根据客户情报掌控业务发展方向。

Web SDK到Adobe Analytics的关系图

学习目标

在本课程结束后，您将能够：

  • 配置数据流以启用Adobe Analytics
  • 了解哪些标准XDM字段自动映射到Analytics变量
  • 在数据对象中设置Analytics变量
  • 通过覆盖数据流将数据发送到其他报表包
  • 使用Debugger和Assurance验证Adobe Analytics变量

先决条件

要完成本课程，您必须首先：

  • 熟悉并访问Adobe Analytics。

  • 至少具有一个测试/开发报表包ID。 如果您没有可用于本教程的测试/开发报表包，请创建一个。

  • 完成本教程的初始配置和标记配置部分中之前的课程。

配置数据流

Platform Web SDK将数据从您的网站发送到PlatformEdge Network。 然后，您的数据流会告知PlatformEdge Network，您的数据应该发送到哪个Adobe Analytics报表包。

  1. 转到数据收集接口

  2. 在左侧导航中，选择​ 数据流

  3. 选择之前创建的Luma Web SDK: Development Environment数据流

    选择Luma Web SDK数据流

  4. 选择​ 添加服务
    向数据流添加服务

  5. 选择​ Adobe Analytics ​作为​ 服务

  6. 输入开发报表包的​ 报表包ID

  7. 选择​ 保存

    数据流保存分析

    note tip
    TIP
    通过选择​ 添加报表包 ​添加更多报表包等同于多包标记。
WARNING
在本教程中，您将仅为开发环境配置Adobe Analytics报表包。 在为您自己的网站创建数据流时，您应该为暂存环境和生产环境创建其他数据流和报表包。

设置Analytics变量

有多种方法可以在Web SDK实施中设置Analytics变量：

  1. XDM字段到Analytics变量的自动映射（自动）。
  2. 在data对象中设置字段（推荐）。
  3. 在Analytics处理规则中将XDM字段映射到Analytics变量（不再推荐）。
  4. 直接在XDM架构中映射到Analytics变量（不再推荐）。

自2024年5月起，您不再需要创建XDM模式来使用Platform Web SDK实施Adobe Analytics。 data对象（以及您在创建数据元素课程中创建的data.variable数据元素）可用于设置所有自定义Analytics变量。 现有Analytics客户将会很熟悉在数据对象中设置这些变量，并且比使用处理规则界面更有效，还可以防止不必要的数据占用实时客户配置文件中的空间(如果您有Real-time Customer Data Platform或Journey Optimizer，这一点很重要)。

自动映射的字段

许多XDM字段会自动映射到Analytics变量。 有关最新的映射列表，请参阅AdobeExperience Edge🔗中的Analytics变量映射。

即使您尚未定义自定义架构​ ，如果 ​也会发生这种情况。 Experience PlatformWeb SDK会自动收集一些数据，并将其作为XDM字段发送到PlatformEdge Network。 例如，Web SDK读取当前页面URL并将其作为XDM字段web.webPageDetails.URL发送。 此字段将转发到Adobe Analytics，并且它会自动在Adobe Analytics中填充页面URL报表。

如果您使用XDM架构实施适用于Adobe Analytics的Web SDK，如本教程中所述，则您已经自定义实施了一些自动映射到Analytics变量的XDM字段，如下表所述：

XDM到Analytics的自动映射变量
Adobe Analytics变量
identitymap.ecid.[0].id
mid
web.webPageDetails.name
s.pageName
web.webPageDetails.server
s.server
web.webPageDetails.siteSection
s.channel
commerce.productViews.value
prodView
commerce.productListViews.value
scView
commerce.checkouts.value
scCheckout
commerce.purchases.value
购买
commerce.order.currencyCode
s.currencyCode
commerce.order.purchaseID
s.purchaseID
productListItems[].SKU
s.products=；产品名称；；；；；（主要 — 请参阅下面的注释）
productListItems[].name
s.products=；产品名称；；；；；（回退 — 请参阅下面的注释）
productListItems[].quantity
s.products=；；product quantity；；；
productListItems[].priceTotal
s.product=；；；产品价格；；

Analytics产品字符串的各个部分通过productListItems对象下的不同XDM变量进行设置。

NOTE
自2022年8月18日起，productListItems[].SKU优先映射到s.products变量中的产品名称。
仅当productListItems[].SKU不存在时，设置为productListItems[].name的值才会映射到产品名称。 否则，它将被取消映射，并可用于上下文数据。
请勿将空字符串或null设置为productListItems[].SKU。 这会产生不需要的效果，即映射到s.products变量中的产品名称。

在数据对象中设置变量

但evar、prop和事件呢？ 建议使用Web SDK在data对象中设置变量来设置这些Analytics变量。 在数据对象中设置变量还可以覆盖任何自动映射的变量。

首先，data对象是什么？ 在任何Web SDK事件中，您可以使用自定义数据发送两个对象： xdm对象和data对象。 两者都会发送到PlatformEdge Network，但只将xdm对象发送到Experience Platform数据集。 可以使用为数据收集准备数据功能，将Edge上data对象中的属性映射到xdm字段，否则不会发送到Experience Platform。 这使其成为将数据发送到Analytics等并非基于Experience Platform构建的原生应用程序的理想方式。

以下是通用Web SDK调用中的两个对象：

数据和xdm对象

Adobe Analytics配置为在data.__adobe.analytics对象中查找任何属性，并将其用于Analytics变量。

现在，让我们看看这是如何运行的。 让我们使用页面名称设置eVar1和prop1，看看如何覆盖XDM映射的值

  1. 打开标记规则all pages - library loaded - set global variables - 1
  2. 添加新的​ 操作
  3. 选择​ Adobe Experience Platform Web SDK ​扩展
  4. 选择​ 操作类型 ​作为​ 更新变量
  5. 选择data.variable作为​ 数据元素
  6. 选择​ analytics ​对象
  7. 将eVar1设置为page.pageInfo.pageName数据元素
  8. 设置prop1以复制eVar1的值
  9. 要测试XDM映射值的覆盖，请在​ 其他属性 ​部分中将页面名称设置为静态值test
  10. 保存规则

现在，我们需要在发送事件规则中包含数据对象。

  1. 打开标记规则all pages - library loaded - send event - 50
  2. 打开​ 发送事件 ​操作
  3. 选择data.variable作为​ 数据
  4. 选择​ 保留更改
  5. 选择​ 保存

将数据发送到其他报表包

您可能希望更改当访客出现在某些页面中时，要将哪些Adobe Analytics报表包数据发送到。 这需要数据流和规则中的配置。

为报表包覆盖配置数据流

要在数据流中配置Adobe Analytics报表包覆盖设置，请执行以下操作：

  1. 打开您的数据流

  2. 编辑​ Adobe Analytics ​配置，方法是打开 更多 菜单，然后选择​ 编辑

    覆盖数据流

  3. 选择​ 高级选项 ​以打开​ 报表包覆盖

  4. 选择要覆盖的报表包。 在这种情况下，Web SDK Course Dev和Web SDK Course Stg

  5. 选择​ 保存

    覆盖数据流

为报表包覆盖配置规则

让我们创建一个规则以向其他报表包发送额外的页面查看调用。 使用数据流覆盖功能，通过​ 发送事件 ​操作更改页面的报表包。

  1. 创建新规则，将其命名为homepage - library loaded - AA report suite override - 51

  2. 选择​ 事件 ​下的加号以添加新触发器

  3. 在​ 扩展 ​下，选择​ 核心

  4. 在​ Event Type ​下，选择​ Library Loaded (Page Top)

  5. 选择以打开​ 高级选项，键入51。 这将确保规则在设置具有​ 更新变量 ​操作类型的基线XDM的all pages - library loaded - send event - 50之后运行。

  6. 选择​ 保留更改

    Analytics报表包覆盖

  7. 在​ 条件 ​下，选择​ 添加

  8. 将​ 逻辑类型 ​保留为​ 常规

  9. 将​ 扩展 ​保留为​ 核心

  10. 选择​ 条件类型 ​作为不含查询字符串​ 的 ​路径

  11. 在右侧，将​ 正则表达式 ​切换保持禁用状态

  12. 在​ 路径下，等于 ​设置/content/luma/us/en.html。 对于Luma演示站点，它确保规则仅在主页上触发

  13. 选择​ 保留更改

    Analytics报表包覆盖条件

  14. 在​ 操作 ​下，选择​ 添加

  15. 作为​ 扩展，请选择​ Adobe Experience Platform Web SDK

  16. 作为​ 操作类型，请选择​ 发送事件

  17. 对于​ XDM数据，请选择您在创建数据元素课程中创建的xdm.variable.content数据元素

  18. 作为​ 数据，选择您在创建数据元素课程中创建的data.variable数据元素

    Analytics数据流覆盖

  19. 向下滚动到​ 数据流配置覆盖 ​部分

  20. 保持选中​ 开发 ​选项卡。

    note tip
    TIP
    此选项卡确定覆盖发生在哪个标记环境中。 对于此练习，您仅指定了开发环境，但在将此环境部署到生产环境时，请记得也在​ 生产 ​环境中指定该环境。

  21. 选择您用于本教程的​ 沙盒

  22. 选择​ 数据流，在此例中为Luma Web SDK: Development Environment

  23. 在​ 报表包 ​下，选择要覆盖的报表站点。 在这种情况下，tmd-websdk-course-stg。

  24. 选择​ 保留更改

  25. 并​ 保存 ​您的规则

    Analytics数据流覆盖

构建开发环境

将更新的规则添加到Luma Web SDK Tutorial标记库中，并重新构建开发环境。

恭喜！下一步是通过Experience PlatformWeb SDK验证Adobe Analytics实施。

使用Debugger验证Adobe Analytics

了解如何使用Adobe Analytics Debugger的Edge跟踪功能验证Experience Platform是否正在捕获ECID、页面查看、产品字符串和电子商务事件。

在Debugger课程中，您已了解如何使用Platform Debugger和浏览器开发人员控制台检查客户端XDM请求，这与您调试AppMeasurement.js Analytics实施的方法类似。 您还了解了如何验证发送到Adobe应用程序的平台Edge Network服务器端请求，以及如何使用Assurance查看完全处理的负载。

要验证Analytics是否通过Experience PlatformWeb SDK正确捕获数据，您必须进一步执行两个步骤：

  1. 使用Experience PlatformDebugger的Edge跟踪功能，验证平台Edge Network上的XDM对象如何处理数据
  2. 使用Adobe Experience Platform保障验证Analytics完全处理数据的方式

Experience CloudID验证

  1. 转到Luma演示网站

  2. 选择右上角的登录按钮，并使用凭据u： test@adobe.com p：测试进行身份验证

  3. 打开Experience Platform调试器，然后将网站上的标记属性切换到您自己的开发属性

  4. 要启用Edge跟踪，请转到Experience Platform调试器，在左侧导航中选择​ 日志，然后选择​ Edge ​选项卡，然后选择​ 连接

    连接Edge跟踪

  5. 现在它将为空

    连接的Edge跟踪

  6. 刷新“Luma”页面并再次检查Experience Platform调试器，您应该会看到数据通过。 以​ Analytics自动映射 ​开头的行是Adobe Analytics信标

  7. 选择以打开mappedQueryParams下拉列表和第二个下拉列表以查看Analytics变量

    Analytics信标Edge跟踪

    note tip
    TIP
    第二个下拉列表对应于您要将数据发送到的分析报表包ID。 它应该与您自己的报表包匹配，而不是与屏幕快照中的报表包匹配。

  8. 向下滚动以查找c.a.x.identitymap.ecid.[0].id。 它是一个捕获ECID的上下文数据变量

  9. 继续向下滚动，直到看到Analytics mid变量。 两个ID均与设备的Experience CloudID匹配。

  10. 在Luma网站上，

    Analytics ECID

    note note
    NOTE
    由于您已登录，请花些时间验证c.a.x.identitymap.lumacrmid.[0].id中已捕获的用户​**test@adobe.com**​的身份验证ID 112ca06ed53d3db37e4cea49cc45b71e

报表包覆盖验证

您在上面为Luma主页配置了数据流覆盖。 验证此配置的步骤

  1. 在应用覆盖后查找具有​ 数据流配置的行。 在这里，您可以找到为报表包覆盖配置的主报表包和其他报表包。

    Analytics报表包覆盖列表验证

  2. 向下滚动到以​ Analytics自动映射 ​开头的行，并验证reportSuiteIds是否显示您在覆盖配置中指定的报表包

    Analytics报表包覆盖调用验证

内容页面查看次数验证

转到Didi Sport Watch产品页等产品页。 验证Analytics是否捕获了内容页面查看。

  1. 查找c.a.x.web.webpagedetails.pageviews.value=1。

  2. 向下滚动以查看gn变量。 它是s.pageName变量的Analytics动态语法。 它从数据层捕获页面名称。

    Analytics产品字符串

产品字符串和电子商务事件验证

由于您已在产品页面上，因此本练习将继续使用相同的Edge跟踪来验证Analytics捕获的产品数据。 产品字符串和电子商务事件都会自动将XDM变量映射到Analytics。 只要您在为Adobe Analytics配置XDM架构时映射到适当的productListItem XDM变量，PlatformEdge Network就会负责将数据映射到适当的Analytics变量。

首先验证Product String是否已设置

  1. 查找c.a.x.productlistitems.[0].sku。 变量会捕获您在本课程中之前映射到productListItems.item1.sku的数据元素值

  2. 同时查找c.a.x.productlistitems.[0]._experience.analytics.customdimensions.evars.evar1。 变量捕获您映射到productListItems.item1._experience.analytics.customdimensions.evars.evar1的数据元素值

  3. 向下滚动以查看pl变量。 它是Analytics产品字符串变量的动态语法

  4. 请注意，数据层中的产品名称同时映射到产品字符串的c.a.x.productlistitems.[0].sku和product参数。 此外，数据层中的产品标题会映射到products string中的推销evar1。

    Analytics产品字符串

    Edge跟踪对commerce事件的处理方式与productList维度略有不同。 您不会看到上下文数据变量以与看到映射到上述c.a.x.productlistitem.[0].name的产品名称相同的方式进行映射。 Edge跟踪反而会在Analytics event变量中显示最终事件自动映射。 在为Adobe Analytics配置架构时，只要映射到适当的XDM commerce变量，平台Edge Network就会相应地映射它；在本例中为commerce.productViews.value=1。

  5. 返回Experience Platform调试器窗口，向下滚动到events变量，该变量设置为prodView

  6. 另请注意，c.a.x.eventType设置为commerce.productViews，因为您位于产品页面上。

    note tip
    TIP
    ecommerce - pdp library loaded - AA (order 20)规则正在覆盖all pages global content variables - library loaded - AA (order 1)规则设置的eventType的值，因为该规则设置为稍后在序列中触发

    Analytics产品视图

验证为Analytics设置的其余电子商务事件和产品字符串

  1. 将Didi Sport Watch添加到购物车

  2. 转到购物车页面，查看Edge跟踪

    • eventType设置为commerce.productListViews
    • events: "scView"，和
    • 设置product string

    Analytics购物车查看

  3. 继续结帐，检查Edge跟踪

    • eventType设置为commerce.checkouts
    • events: "scCheckout"，和
    • 设置product string

    Analytics签出

  4. 只需填写发货单上的​ 名字 ​和​ 姓氏 ​字段，然后选择​ 继续。 在下一页上，选择​ 下订单

  5. 在确认页面上，检查Edge跟踪

    • eventType设置为commerce.purchases
    • 正在设置events: "purchase"的购买事件
    • 正在设置的货币代码变量cc: "USD"
    • 在pi中设置购买ID
    • 产品字符串pl设置产品名称、数量和价格

    Analytics购买

使用Assurance验证Adobe Analytics

Adobe Experience Platform Assurance可帮助您检查、验证、模拟和验证您收集数据或向网站和移动应用程序提供体验的方式。

在上一个练习中，您已验证Adobe Analytics是否使用Debugger的Edge跟踪功能捕获ECID、页面查看次数、产品字符串和Experience Platform事件。 接下来，使用Adobe Experience Platform Assurance(用于在Edge跟踪中访问相同数据的替代界面)验证这些相同事件。

如您在保证课程中所学的，有几种方法可启动保证会话。 由于您已经使用上一个练习中启动的Edge跟踪会话打开了Adobe Experience Platform Debugger，因此我们建议您通过Debugger访问Assurance：
通过Adobe Experience Platform数据收集提供 保证

在​ “Web SDK教程3” ​保障会话中，在事件搜索栏中输入​ “hitdebugger”，以便通过Adobe Analytics Post已处理数据筛选结果。
保证Adobe分析Post已处理数据

Experience CloudID验证

要验证Adobe Analytics是否正在捕获ECID，请选择一个信标并打开有效负载。 此信标的供应商应为​ com.adobe.analytics.hitdebugger
Adobe Analytics验证（含保证）

然后向下滚动到​ mcvisId ​以验证是否正确捕获了ECID
Experience CloudID验证（含保证）

内容页面查看次数验证

使用相同的信标，验证内容页面查看是否已映射到正确的Adobe Analytics变量。
向下滚动到​ pageName ​以验证是否正确捕获了Page Name
使用保证验证页面名称

产品字符串和电子商务事件验证

按照使用上述Experience Platform调试器进行验证时所使用的相同验证用例，继续使用相同的信标来验证Ecommerce Events和Product String。

  1. 查找​ 事件 ​包含prodView的有效负载
    产品字符串验证（含保证）
  2. 向下滚动到​ product-string ​以验证Product String。
    • 注意Product SKU和Merchandizing eVar1。
  3. 进一步向下滚动，验证您使用上一节中的处理规则配置的prop1是否包含Product SKU
    带保证的促销变量验证的产品字符串

通过查看购物车、结帐和购买事件来继续验证实施。

  1. 查找​ 事件 ​包含scView的有效负载并验证产品字符串。
    产品字符串验证（含保证）
  2. 查找​ 事件 ​包含scCheckout的有效负载并验证产品字符串。
    产品字符串验证（含保证）
  3. 查找​ 事件 ​包含purchase的有效负载
    产品字符串验证（含保证）
  4. 验证purchase事件时，请注意Product String应包含Product SKU、Product Quantity和Product Total Price。
  5. 此外，对于purchase，请验证purchase-id和/或purchaseId是否已设置

恭喜！你做到了！ 在本课程结束时，您已准备好使用Platform Web SDK为您自己的网站实施Adobe Analytics。

下一步：

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