配置Web SDK标记扩展
Web SDK标记扩展通过Experience PlatformEdge Network从Web资产向Adobe Experience Cloud发送数据。
该扩展允许您将数据流式传输到Platform、同步身份、处理客户同意信号并自动收集上下文数据。
本文档介绍如何在标记UI中配置标记扩展。
安装Web SDK标记扩展 install
Web SDK标记扩展需要在上安装资产。 如果您尚未这样做，请参阅有关创建标记属性的文档。
创建属性后，打开该属性并选择左侧栏上的 扩展 选项卡。
选择 目录 选项卡。 从可用扩展列表中，找到Web SDK扩展并选择 安装。
选择 安装 后，必须配置Web SDK标记扩展并保存配置。
配置实例设置 general
页面顶部的配置选项可告知Adobe Experience Platform将数据路由到何处以及要在服务器上使用的配置。
- 名称： Adobe Experience Platform Web SDK扩展支持页面上的多个实例。 该名称用于通过标记配置向多个组织发送数据。 实例名称默认为
alloy。 但是，您可以将实例名称更改为任何有效的JavaScript对象名称。 - IMS组织ID：您希望在Adobe时向其发送数据的组织的ID。 大多数情况下，使用自动填充的默认值。 当页面上有多个实例时，使用您要向其发送数据的第二个组织的值填充此字段。
- Edge域：扩展发送和接收数据的域。 Adobe建议对此扩展使用第一方域(CNAME)。 默认的第三方域适用于开发环境，但不适合生产环境。此处列出了有关如何设置第一方 CNAME 的说明。
配置数据流设置 datastreams
此部分允许您为三个可用环境（生产、暂存和开发）中的每一个选择应使用的数据流。
向Edge Network发送请求时，将使用数据流ID来引用服务器端配置。 您无需在网站上更改代码即可更新配置。
请参阅数据流指南，了解如何配置数据流。
您可以从可用下拉菜单中选择数据流，也可以选择 输入值 并为每个环境输入自定义数据流ID。
配置隐私设置 privacy
在此部分中，您可以配置Web SDK如何处理来自您网站的用户同意信号。 具体来说，它允许您选择在没有提供其他明确的同意首选项的情况下假定为用户的默认同意级别。
默认同意级别未保存到用户配置文件。
配置身份设置 identity
利用此部分，可定义Web SDK在处理用户标识时的行为。
-
从VisitorAPI迁移ECID：默认情况下启用此选项。 启用此功能后，SDK可以读取
AMCV和s_ecidCookie并设置Visitor.js使用的AMCVCookie。 在迁移到Web SDK时，此功能很重要，因为某些页面可能仍在使用Visitor.js。 此选项允许SDK继续使用相同的ECID，这样用户就不会被标识为两个单独的用户。 -
使用第三方Cookie：启用此选项后，Web SDK会尝试将用户标识符存储在第三方Cookie中。 如果成功，则在用户跨多个域导航时将用户标识为单个用户，而不是在每个域上将用户标识为单独的用户。 如果启用此选项，则当浏览器不支持第三方Cookie或用户已配置为不允许第三方Cookie时，SDK仍可能无法将用户标识符存储在第三方Cookie中。 在这种情况下，SDK仅将标识符存储在第一方域中。
note important IMPORTANT >第三方Cookie与Web SDK中的第一方设备ID功能不兼容。
您可以使用第一方设备ID，也可以使用第三方Cookie，但不能同时使用这两项功能。
配置个性化设置 personalization
利用此部分，可配置在加载个性化内容时如何隐藏页面的某些部分。 这可确保访客仅看到个性化页面。
- 将Target从at.js迁移到Web SDK：使用此选项可允许Web SDK读取和写入at.js
1.x或2.x库使用的旧版mbox和mboxEdgeClusterCookie。 这有助于在从使用Web SDK的页面移动到使用at.js1.x或2.x库的页面时保留访客配置文件，反之亦然。
预隐藏样式 prehiding-style
使用预隐藏样式编辑器，可定义自定义CSS规则以隐藏页面的特定部分。 在加载页面时，Web SDK使用此样式来隐藏需要个性化的部分，检索个性化，然后取消隐藏个性化的页面部分。 这样，您的访客将看到已个性化的页面，而不看到个性化检索过程。
预隐藏代码片段 prehiding-snippet
异步加载Web SDK库时，预隐藏代码片段很有用。 在这种情况下，为了避免闪烁，我们建议在加载Web SDK库之前隐藏内容。
要使用预隐藏代码片段，请将其复制并粘贴到页面的<head>元素中。
配置数据收集设置 data-collection
管理数据收集配置设置。 JavaScript库中的类似设置可以使用configure命令使用。
-
在事件发送回调之前：一个回调函数，用于评估和修改发送给Adobe的有效负载。 使用回调函数中的
content变量修改有效负载。 此回调是相当于JavaScript库中onBeforeEventSend的标记。 -
收集内部链接点击次数：用于收集网站或属性内部链接跟踪数据的复选框。 启用此复选框后，将显示事件分组选项：
- 无事件分组：链接跟踪数据在单独事件中发送到Adobe。 在单独事件中发送链接点击次数可能会增加发送到Adobe Experience Platform的数据在合同中的使用量。
- 使用会话存储进行事件分组：将链接跟踪数据存储在会话存储中，直到发生下一页事件。 在下一页上，存储的链接跟踪数据和页面查看数据同时发送到Adobe。 Adobe建议在跟踪内部链接时启用此设置。
- 使用本地对象进行事件分组：将链接跟踪数据存储在本地对象中，直到发生下一页事件。 如果访客导航到新页面，则链接跟踪数据将丢失。 此设置在单页应用程序的上下文中最为有用。
-
收集外部链接点击次数：启用外部链接收集的复选框。
-
收集下载链接点击次数：用于收集下载链接的复选框。
-
下载链接限定符：将链接URL限定为下载链接的正则表达式。
-
筛选点击属性：一个回调函数，用于在集合之前评估和修改与点击相关的属性。 此函数在事件发送回调之前的On之前运行。
-
上下文设置：自动收集访客信息，这些信息会为您填充特定的XDM字段。 您可以选择 所有默认上下文信息 或 特定上下文信息。 该标记等同于JavaScript库中的
context。- Web：收集有关当前页面的信息。
- 设备：收集有关用户设备的信息。
- 环境：收集有关用户浏览器的信息。
- 放置上下文：收集有关用户位置的信息。
- 高熵用户代理提示：收集有关用户设备的更多详细信息。
onBeforeLinkClickSend。 使用 筛选点击属性 回调筛选或调整点击数据，或者使用 在事件发送回调前开启 筛选或调整发送给Adobe的整体有效负载。 如果同时设置了 筛选条件点击属性 回调和 在链接点击之前打开 回调，则只有 筛选条件点击属性 回调运行。配置媒体收集设置 media-collection
媒体收集功能可帮助您收集与网站上的媒体会话相关的数据。
收集的数据可以包括有关媒体回放、暂停、完成和其他相关事件的信息。 收集之后，您可以将此数据发送到Adobe Experience Platform和/或Adobe Analytics以生成报表。 此功能为跟踪和了解您网站上的媒体消费行为提供了全面的解决方案。
配置数据流覆盖 datastream-overrides
数据流覆盖允许您为数据流定义其他配置，这些配置通过 Web SDK 传递到 Edge Network。
这可以帮助您触发与默认数据流行为不同的数据流行为，而无需创建新的数据流或修改现有设置。
数据流配置覆盖是一个两步过程：
- 首先，您必须在数据流配置页面中定义数据流配置覆盖。
- 然后，您必须通过Web SDK命令或Web SDK标记扩展将覆盖发送到Edge Network。
有关如何覆盖数据流配置的详细说明，请参阅数据流配置覆盖文档。
作为通过Web SDK命令传递覆盖的替代方法，您可以在下面显示的标记扩展屏幕中配置覆盖。
配置高级设置
如果需要更改用于与Edge Network交互的基路径，请使用 Edge基路径 字段。 这不需要更新，但是如果您参与Beta或Alpha测试，Adobe可能会要求您更改此字段。
