发行说明

最近更新： 2025年5月21日
  • 主题：

创建对象：

  • 开发人员

本文档介绍Adobe Experience Platform Web SDK的发行说明。
有关Web SDK标记扩展的最新发行说明，请参阅Web SDK标记扩展发行说明。

2.27.0版 — 2025年5月20日

修复和改进

  • 修复了应用程序内消息中自定义样式应用不正确的问题。
  • 更改了事件历史记录的格式。 这将导致在删除旧历史记录数据时重新显示应用程序内消息和内容卡。
  • 修复了在SPA用例中重新应用建议的问题。
  • 修复了对影子DOM元素进行点击跟踪的问题。

版本2.26.0 - 2025年3月5日

新增功能

  • 您现在可以使用Web SDK NPM包创建自定义Web SDK内部版本，并仅选择所需的库组件。 这可以减小库大小并优化加载时间。 请参阅有关如何使用NPM包创建自定义Web SDK内部版本的文档。
  • getIdentity命令现在会自动直接从kndctr身份Cookie中读取ECID。 如果您使用ECID命名空间调用getIdentity，并且已存在身份Cookie，则Web SDK不再向Edge Network发出获取身份的请求。 现在，它会从Cookie中读取身份。

修复和改进

  • 修复了在发送collect调用后getIdentity命令未返回标识的问题。
  • 修复了个性化重定向导致内容在重定向发生之前闪烁的问题。

版本2.25.0 - 2025年1月23日

已修复和改进

  • 向setDebug命令添加了选项验证。
  • 添加了一个警告，在禁用单击收集时配置onBeforeLinkClickSend函数或下载链接限定符。
  • 修复了呈现的建议未包含在显示通知中的问题。

新增功能

  • 在启用了第三方Cookie并阻止对adobedc.demdex.net的请求时，对配置的Edge域实施了回退。

版本2.24.1 - 2024年12月6日

已修复和改进

版本2.24.0 - 2024年10月31日

新增功能

修复和改进

  • 当返回多个应用程序内消息时，只会显示具有最高优先级的消息。 其它则被记录为隐含。

  • 空数据流覆盖不再发送到Edge Network，从而减少与服务器端路由配置的潜在冲突。

  • 重命名了以下日志消息组件名称，以与其他Adobe SDK保持一致：

    • DecisioningEngine已重命名为RulesEngine
    • LegacyMediaAnalytics已重命名为MediaAnalyticsBridge
    • Privacy已重命名为Consent

  • 修复了通过applyPropositions呈现默认内容项时发生的错误。

  • 修复了Adobe Target移动和调整操作大小时的CSS错误。

  • 已从sendEvent响应中删除machineLearning键。

版本2.23.0 - 2024年9月19日

新增功能

修复和改进

  • 修复了在本地运行Web SDK时无法正确写入Cookie的问题。

版本2.22.0 - 2024年8月22日

新增功能

  • 添加了对个性化监控挂接的支持。

修复和改进

  • 删除了对Internet Explorer的支持，将库gzip大小减少了9%。
  • 修复了在调用onInstanceConfigured监视器挂接时未初始化Activity Map链接详细信息的问题。
  • 修复了Cookie目标未设置为正确路径的问题。
  • 修复了调用具有的客户问题。
  • 修复了adobe_mc参数中的无效URL编码导致sendEvent调用失败的问题。

2.21.1版 — 2024年7月18日

修复和改进

  • 修复了使用NPM库时的生成错误。

2.21.0版 — 2024年7月16日

新增功能

  • 添加了对自动建议交互跟踪的支持。
  • 添加了提供alloy.js文件的自定义构建脚本。
  • 通过ActivityMap和事件分组支持改进了点击收集。

2.20.0版 — 2024年5月21日

新增功能

修复和改进

  • 修复了在选择禁用同意时，导致默认内容被预隐藏代码片段隐藏的错误。

版本2.19.2 - 2024年1月10日

修复和改进

  • 修复了标识错误正在掩蔽其他错误，并将标识错误更改为警告的问题。
  • 修复了当renderDecisions设置为false的页面顶部调用时，页面底部调用绝不会发送的问题。
  • 修复了在存在多个adobe_mc查询字符串参数时，Web SDK无法读取跨域标识的问题。

版本 2.19.1 - 2023 年 11 月 10 日

修复和改进

  • 修复了从sendEvent调用返回的建议数组始终为空的问题。

版本2.19.0 - 2023年11月1日

新增功能

修复和改进

  • 在呈现多种类型的个性化时，组合的个性化会显示多个事件。
  • 修复了单页面应用程序视图名称区分大小写的问题。
  • 修复了影子DOM个性化优惠选择器的问题。

2.18.0版 — 2023年7月31日

新增功能

  • 添加了对数据流ID🔗的每命令覆盖的支持。

修复和改进

  • 修复了由于域是查询的一部分而导致退出链接不符合条件的问题。
  • 在Web SDK配置中弃用edgeConfigId而支持datastreamId。

2.17.0版 — 2023年5月17日

修复和改进

版本2.16.0 - 2023年4月25日

新增功能

版本2.15.0 - 2023年3月30日

新增功能

  • 添加了对onBeforeLinkClickSend链接点击回调的支持。
  • 添加了对Adobe Journey Optimizer点击跟踪的支持。

修复和改进

  • 现在，链接收藏集包含链接名称和访客区域。
  • 移除了失败URL目标的控制台错误。

版本2.14.0 - 2023年1月25日

  • (Beta)添加了对Adobe Journey Optimizer表面和建议的支持。

修复和改进

  • 修复了Adobe Target VEC自定义代码操作的一个问题，该问题导致代码被插入到at.js以外的其他位置。
  • 修复了在某些边缘情况下，对Edge Network的请求未正确设置“referer”标头的问题。
  • 修复了用户代理客户端提示属性可能设置为不正确类型的问题。
  • 修复了placeContext.localTime与架构不匹配的问题。

版本2.13.1 - 2022年10月13日

  • 修复了在配置后定义window.Visitor时访客迁移不起作用的问题。 当使用Adobe标记运行时，这个问题尤为突出。
  • 修复了在某些环境中将device.screenWidth和device.screenHeight填充为字符串的问题。

版本2.13.0 - 2022年9月28日

新增功能

修复和改进

  • 修复了在禁用链接跟踪时个性化点击跟踪量度未更新的问题。
  • 更新了在指定未知选项时引发验证错误的命令。
  • 自动发送显示和交互个性化事件时现在会填充_experience.decisioning.propositionEventType属性。
  • 为getIdentity命令添加了重复的命名空间验证。
  • 为sendEvent命令添加了重复的决定范围验证。

版本2.12.0 - 2022年6月29日

  • 将对Edge Network的请求更改为使用cluster Cookie位置提示作为URL的一部分。 这可确保会话期间更改其位置（例如，通过VPN或带着移动设备开车等）的用户点击同一边缘并具有相同的个性化配置文件。
  • 在getLibraryInfo命令响应中字符串化已配置的函数。

版本2.11.0 - 2022年6月13日

新增功能

  • 现在，通过在移动应用程序和移动Web内容之间以及跨域共享访客ID，您可以更准确地提供个性化体验。 有关详细信息，请参阅专用文档。
  • 您现在可以将Adobe Target中的一系列建议渲染或执行到单页应用程序中，而无需增加Analytics量度。 这减少了报告错误，并提高了分析准确性。 有关详细信息，请参阅专用文档。
  • 向getLibraryInfo命令添加了其他信息，包括可用命令和实例的最终配置。

修复和改进

  • 更新了Cookie设置以在HTTPS页面上使用sameSite="none"和secure标记。
  • 修复了在使用eq伪选择器时个性化内容未正确应用的问题。
  • 修复了localTimezoneOffset可能无法通过Experience Platform验证的问题。

版本2.10.1 - 2022年5月3日

  • 修复了为ID同步和区段目标创建多个永久iframe的问题。

版本2.10.0 - 2022年4月22日

  • 对所有ID同步和区段目标使用永久性iframe。
  • 修复了合并的量度建议在sendEvent结果中重复的问题。

版本2.9.0 - 2022年3月10日

  • 添加了对跟踪control (default)Adobe Target体验的支持。
  • 优化了单页应用程序的查看 — 更改事件。 现在，在呈现个性化体验时，显示通知包含在查看 — 更改事件中。
  • 已移除不存在eventType时的控制台警告。
  • 修复了在缓存中请求或检索体验时仅从sendEvent命令返回propositions属性的问题。 propositions属性现在将始终定义为数组。
  • 修复了从Edge Network返回错误时，未显示隐藏容器的问题。
  • 修复了Adobe Target中未计算interact事件的问题。 通过将视图名称添加到XDM的web.webPageDetails.viewName中修复了此问题。
  • 修复控制台消息中损坏的文档链接。

版本2.8.0 - 2022年1月19日

  • 支持个性化的影子DOM选择器。
  • 重命名了个性化事件类型。 （display和click成为decisioning.propositionDisplay和decisioning.propositionInteract）
  • 修复了以下问题：带有内联脚本标记的HTML选件将脚本标记两次添加到页面中，即使脚本只运行一次。

版本 2.7.0 - 2021 年 10 月 26 日

  • 在sendEvent的返回值中公开来自Edge Network的其他信息，包括inferences和destinations。 由于这些功能当前正在作为Beta的一部分推出，因此这些属性的格式可能会发生更改。

版本2.6.4 - 2021年9月7日

  • 修复了应用于head元素的设置HTML Adobe Target操作将替换整个head内容的问题。 现在，将应用于head元素的HTML操作更改为附加HTML。

版本2.6.3 - 2021年8月16日

  • 修复了通过configure命令的已解析承诺公开非公共用途对象的问题。

版本2.6.2 - 2021年8月4日

  • 修复了以下问题：即使未访问result.decisions属性，result.decisions的弃用（由sendEvent命令提供）警告也会记录到控制台。 访问result.decisions属性时不会记录任何警告，但该属性仍被弃用。

版本2.6.1 - 2021年7月29日

  • 修复了呈现没有个性化内容的单页应用程序视图的个性化设置会引发错误并导致sendEvent命令返回的承诺被拒绝的问题。

2.6.0版 — 2021年7月27日

  • 在sendEvent已解决的承诺中提供更多的个性化内容，包括Adobe Target响应令牌。 执行sendEvent命令时，将返回一个promise，该承诺最终将由包含从服务器接收的信息的result对象解析。 以前，此结果对象包含一个名为decisions的属性。 该decisions属性已被弃用。 已添加新属性propositions。 此新属性使客户能够访问更多个性化内容，包括响应令牌。

版本2.5.0 - 2021年6月

  • 添加了对重定向个性化选件的支持。
  • 自动收集的负值视区宽度和高度将不再发送到服务器。
  • 现在，当通过从onBeforeEventSend回调返回false而取消事件时，将记录一条消息。
  • 修复了用于单个事件的特定XDM数据片段包含在多个事件中的问题。

版本2.4.0 - 2021年3月

  • SDK现在可以作为NPM包安装。
  • 在配置默认同意时添加了对out选项的支持，默认同意会丢弃所有事件，直到收到同意为止（现有pending选项将事件排入队列，并在收到同意后发送它们）。
  • onBeforeEventSend回调现在可用于阻止发送事件。
  • 在发送有关正在呈现或单击的个性化内容的事件时，现在使用XDM架构字段组而不是meta.personalization。
  • getIdentity命令现在会随身份一起返回边缘区域ID。
  • 从服务器收到的警告和错误已得到改进，并以更合适的方式进行处理。
  • 为setConsent命令添加了对Adobe Consent 2.0标准的支持。
  • 收到同意首选项后，将对首选项进行哈希处理并将其存储在本地存储中，以优化CMP、Experience Platform Web SDK和Experience Platform Edge Network之间的集成。 如果您正在收集同意首选项，我们现在鼓励您在每次加载页面时调用setConsent。
  • 已添加两个监视挂接、onCommandResolved和onCommandRejected。
  • 错误修复：当用户导航到新的单页应用程序视图、返回原始视图并单击符合转化条件的元素时，Personalization交互通知事件将包含有关相同活动的重复信息。
  • 错误修复：如果SDK发送的第一个事件将documentUnloading设置为true，则将使用sendBeacon发送该事件，从而导致有关未建立标识的错误。