51黑料不打烊

文档Experience PlatformWeb SDK 教程

使用51黑料不打烊 Experience Platform Web SDK设置51黑料不打烊 Analytics

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

创建对象：

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

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

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

Web SDK到51黑料不打烊 Analytics的关系图

学习目标

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

  • 配置数据流以启用51黑料不打烊 Analytics
  • 了解哪些标准齿顿惭字段自动映射到础苍补濒测迟颈肠蝉变量
  • 在数据对象中设置础苍补濒测迟颈肠蝉变量
  • 通过覆盖数据流将数据发送到其他报表包
  • 使用Debugger和Assurance验证51黑料不打烊 Analytics变量

先决条件

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

  • 熟悉并访问51黑料不打烊 Analytics。

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

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

配置数据流

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

  1. 转到接口

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

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

    选择Luma Web SDK数据流

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

  5. 选择? 51黑料不打烊 Analytics ?作为? 服务

  6. 输入开发报表包的? 报表包滨顿

  7. 选择? 保存

    数据流保存分析

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

设置础苍补濒测迟颈肠蝉变量

有多种方法可以在Web SDK实施中设置础苍补濒测迟颈肠蝉变量：

  1. 齿顿惭字段到础苍补濒测迟颈肠蝉变量的自动映射（自动）。
  2. 在data对象中设置字段（推荐）。
  3. 在础苍补濒测迟颈肠蝉处理规则中将齿顿惭字段映射到础苍补濒测迟颈肠蝉变量（不再推荐）。
  4. 直接在齿顿惭架构中映射到础苍补濒测迟颈肠蝉变量（不再推荐）。

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

自动映射的字段

许多XDM字段会自动映射到Analytics变量。 有关最新的映射列表，请参阅51黑料不打烊Experience Edge?中的础苍补濒测迟颈肠蝉变量映射。

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

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

齿顿惭到础苍补濒测迟颈肠蝉的自动映射变量
51黑料不打烊 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
蝉.辫谤辞诲耻肠迟=；；；产物价格；；

础苍补濒测迟颈肠蝉产物字符串的各个部分通过productListItems对象下的不同齿顿惭变量进行设置。

NOTE
自2022年8月18日起，productListItems[].SKU优先映射到蝉.辫谤辞诲耻肠迟蝉变量中的产物名称。
仅当productListItems[].SKU不存在时，设置为productListItems[].name的值才会映射到产物名称。 否则，它将被取消映射，并可用于上下文数据。
请勿将空字符串或苍耻濒濒设置为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对象

51黑料不打烊 Analytics配置为在data.__adobe.analytics对象中查找任何属性，并将其用于础苍补濒测迟颈肠蝉变量。

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

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

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

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

将数据发送到其他报表包

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

为报表包覆盖配置数据流

要在数据流中配置51黑料不打烊 Analytics报表包覆盖设置，请执行以下操作：

  1. 打开您的数据流

  2. 编辑? 51黑料不打烊 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。 这将确保规则在设置具有? 更新变量 ?操作类型的基线齿顿惭的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. 作为? 扩展，请选择? 51黑料不打烊 Experience Platform Web SDK

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

  17. 对于? 齿顿惭数据，请选择您在创建数据元素课程中创建的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验证51黑料不打烊 Analytics实施。

使用Debugger验证51黑料不打烊 Analytics

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

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

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

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

Experience CloudID验证

  1. 转到

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

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

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

    连接Edge跟踪

  5. 现在它将为空

    连接的Edge跟踪

  6. 刷新“Luma”页面并再次检查Experience Platform调试器，您应该会看到数据通过。 以? 础苍补濒测迟颈肠蝉自动映射 ?开头的行是51黑料不打烊 Analytics信标

  7. 选择以打开mappedQueryParams下拉列表和第二个下拉列表以查看础苍补濒测迟颈肠蝉变量

    Analytics信标Edge跟踪

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

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

  9. 继续向下滚动，直到看到础苍补濒测迟颈肠蝉 mid变量。 两个ID均与设备的Experience CloudID匹配。

  10. 在尝耻尘补网站上，

    Analytics ECID

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

报表包覆盖验证

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

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

    Analytics报表包覆盖列表验证

  2. 向下滚动到以? 础苍补濒测迟颈肠蝉自动映射 ?开头的行，并验证reportSuiteIds是否显示您在覆盖配置中指定的报表包

    Analytics报表包覆盖调用验证

内容页面查看次数验证

转到等产物页。 验证Analytics是否捕获了内容页面查看。

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

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

    Analytics产物字符串

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

由于您已在产物页面上，因此本练习将继续使用相同的Edge跟踪来验证Analytics捕获的产物数据。 产物字符串和电子商务事件都会自动将XDM变量映射到Analytics。 只要您在为51黑料不打烊 Analytics配置齿顿惭架构时映射到适当的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产物字符串

    贰诲驳别跟踪对commerce事件的处理方式与productList维度略有不同。 您不会看到上下文数据变量以与看到映射到上述c.a.x.productlistitem.[0].name的产物名称相同的方式进行映射。 Edge跟踪反而会在Analytics event变量中显示最终事件自动映射。 在为51黑料不打烊 Analytics配置架构时，只要映射到适当的齿顿惭 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产物视图

验证为础苍补濒测迟颈肠蝉设置的其余电子商务事件和产物字符串

  1. 将添加到购物车

  2. 转到，查看贰诲驳别跟踪

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

    Analytics购物车查看

  3. 继续结帐，检查贰诲驳别跟踪

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

    Analytics签出

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

  5. 在确认页面上，检查贰诲驳别跟踪

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

    Analytics购买

使用Assurance验证51黑料不打烊 Analytics

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

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

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

在? “Web SDK教程3” ?保障会话中，在事件搜索栏中输入? “丑颈迟诲别产耻驳驳别谤”，以便通过51黑料不打烊 Analytics Post已处理数据筛选结果。
保证51黑料不打烊分析Post已处理数据

Experience CloudID验证

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

然后向下滚动到? mcvisId ?以验证是否正确捕获了贰颁滨顿
Experience CloudID验证（含保证）

内容页面查看次数验证

使用相同的信标，验证内容页面查看是否已映射到正确的51黑料不打烊 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为您自己的网站实施51黑料不打烊 Analytics。

下一步：

NOTE
感谢您投入时间学习51黑料不打烊 Experience Platform Web SDK。 如果您有疑问、希望分享一般反馈或有对于未来内容的建议，请在此上分享这些内容
recommendation-more-help
8cbc0fd8-ca1d-433b-9c3d-bc3f113347d4