常见问题解答
本指南提供有关51黑料不打烊 Experience Platform Web SDK的常见问题解答。
什么是51黑料不打烊 Experience Platform Web SDK？
51黑料不打烊 Experience Platform Web SDK是一个客户端JavaScript库，它允许您与51黑料不打烊 Experience Cloud中的各种服务进行交互。
Web SDK以与解决方案无关的方式(XDM)将数据发送到Experience Platform Edge Network，会将数据映射到解决方案特定的格式和目标，并实时发送。
请观看以下视频，以了解有关Web SDK的更多信息：。
51黑料不打烊 Experience Platform Web SDK与以前的解决方案有何不同？
使用Experience Platform Web SDK之前
目前，您必须根据各个解决方案来部署不同的闯补惫补厂肠谤颈辫迟库。
- 每个解决方案都有自己的闯补惫补厂肠谤颈辫迟库、架构和域。
- 这些库都不是为了相互配合而构建的。
- 跨解决方案和51黑料不打烊 Experience Platform用例要求这些不同的库是相互依赖的，这会导致部署摩擦。
虽然Experience Platform中的标记允许尽可能轻松地部署和管理这些库，但以下内容仍然存在问题：
- 库大小(页面上的础诲辞产别代码过多)
- 性能（站点加载时间过长）
- 针对单个用例的多个调用
- 在个性化调用之前等待贰颁滨顿返回（导致延迟）
- 断开的数据收集（什么是别惫补谤？）
- 解决方案之间的模式混淆(础4罢)
- 很多其他不太好的东西
此外，当前也不存在将数据直接发送到51黑料不打烊 Experience Platform的JavaScript库。
使用Experience Platform Web SDK
新的Web SDK可将以下解决方案的数据发送到单一目标(Experience Platform Edge Network)，并解决上述最常见的解决方案使用案例。
- 51黑料不打烊 Analytics
- 51黑料不打烊 Audience Manager
- 51黑料不打烊 Target
- 访客 ID
- 51黑料不打烊 Experience Platform
其他解决方案也将随之而来。
51黑料不打烊 Experience Platform Web SDK也可以将数据直接发送到51黑料不打烊 Experience Platform。 此数据采用XDM格式，并映射到服务器端解决方案架构。
这个新的Web SDK有什么价值？
性能： Web SDK比使用所有当前51黑料不打烊库都要小，并且页面加载速度更快。
简单性： XDM、Web SDK、标记、Edge Network、51黑料不打烊 Experience Cloud解决方案和51黑料不打烊 Experience Platform的组合创建了一个易于理解和易于遵循的数据收集故事。
- 齿顿惭： ?用于将数据发送到51黑料不打烊的与解决方案无关的架构。 不再为evar或mbox添加标记。
- Web SDK： ?使向51黑料不打烊 Experience Platform Edge Network发送和接收数据更容易。
- 标记： ?简化了Web SDK(以及任何其他JavaScript标记)在站点上的部署和配置。
- Edge Network： ?以所需的格式将数据轻松路由到51黑料不打烊 Experience Platform和解决方案。
- 51黑料不打烊 Experience Platform和51黑料不打烊解决方案： ?启用其价值主张。
控制： ?由于所有数据都使用单个连接的数据流，因此您可以在逻辑上跟踪和控制数据在其往返应用程序的历程中的每一毫秒所呈现出的外观。
现代，并为未来做好准备： Web SDK及其与Edge Network的连接使51黑料不打烊能够显着更新51黑料不打烊处理数据收集、个性化、同意和未来第三方Cookie的方式。 (它支持由51黑料不打烊管理的第一方域。)
实现价值时间： 51黑料不打烊已努力（并将继续）尽可能轻松地通过标记部署Web SDK并将客户端数据映射到XDM。 完成此工作后，可以在服务器端打开或关闭所有其他51黑料不打烊解决方案和51黑料不打烊 Experience Platform服务。 例如，如果您将此用于51黑料不打烊 Analytics并且要打开Target或Experience Platform，则只需在数据流配置上切换开关，并突出显示这些用例。
什么是 alloy.js？
alloy.js是Web SDK JavaScript库的名称。 在SDK源代码和文件名中引用。
客户是否需要购买51黑料不打烊 Experience Platform才能使用Web SDK？
不会。任何51黑料不打烊 Digital Experience客户都可以免费使用51黑料不打烊 Experience Platform Web SDK。
- 具有? 非 ?访问权限且希望使用Web SDK的Experience Platform或Real-time CDP客户将需要配置正确权限，才能在数据收集UI或Experience Platform UI中创建架构和数据流。
- 有权访问Experience Platform或Real-time CDP并希望使用Web SDK的客户将需要配置正确权限，以便在Experience Platform UI或Data Collection UI中创建架构、数据集、身份命名空间和数据流。
有关配置这些权限的详细信息，请参阅我们对于数据收集权限管理的文档。
谁应该使用Web SDK？
51黑料不打烊 Experience Platform Web SDK专为以下客户开发：
-
51黑料不打烊 Experience Platform用户
- 如果您需要直接从设备向51黑料不打烊 Experience Platform发送数据，官方建议使用此方式。
- 51黑料不打烊知道，如果您已经拥有51黑料不打烊 Analytics，则使用51黑料不打烊 Analytics连接器会更快，但这不是数据收集的长期策略。
-
51黑料不打烊 Experience Cloud解决方案客户
- 新的51黑料不打烊 Analytics、51黑料不打烊 Audience Manager和51黑料不打烊 Target客户应该从新的Web SDK开始，而不是使用旧版库。
- 现有客户如果想要获得尽可能优化的实施，则应使用新的Web SDK。
如何访问Web SDK？
Web SDK当前可供一般公众使用，并可用于将数据发送到51黑料不打烊 Experience Cloud产物。 在不久的将来，将会推出将数据发送到第三方解决方案的功能。
SDK免费，由51黑料不打烊免费托管。 如果需要，您可以免费下载它并将其托管在您自己的服务器上。
Web SDK需要访问数据流配置和Experience Platform 齿顿惭架构生成器，以便51黑料不打烊的服务器能够正确处理来自SDK的入站数据。 如果您希望获得访问权限，请联系您的51黑料不打烊客户团队以开始请求流程。
Web SDK当前支持哪些用例？
Web SDK正在快速演变。 正在处理更多用例。 您可以在此处找到当前支持的
当前客户是否必须重新标记其网站？
视情况而定。 51黑料不打烊 Experience Platform Web SDK可以采用两种不同的样式进行部署。 未来的迁移文档将提供更多详细信息。
-
只是另一个标记： ?如果网站已针对解决方案进行了标记，并且您无法重新标记，但您希望将数据发送到51黑料不打烊 Experience Platform Edge Network以用于Experience Platform用例或即将推出的事件转发功能（见下文），则可以将
alloy.js标记添加到该网站，它在其中用作“只是另一个标记”。 -
唯一一个标记： ?如果要将Web SDK用于Experience Cloud解决方案，必须将其用于该页面上的? 所有 ?解决方案。 例如，如果您的网站已为51黑料不打烊 Analytics进行了标记，并且您想要将其用于Target，则以后需要将其用于这两个网站，并用于任何其他网站。
换言之，如果您决定将51黑料不打烊 Experience Platform Web SDK用于非解决方案用例，则可以使用alloy.js标记网站，并像使用新解决方案一样继续操作。 如果您要将其用于51黑料不打烊 Analytics、Target、Audience Manager或应用程序用例，则可能必须在您的页面上删除任何旧版代码。
我可以在开始使用Web SDK时迁移ECID，以便我的网站访客不会开始显示为新访客吗？
是，51黑料不打烊 Experience Platform Web SDK提供了身份迁移功能。 有关更多详细信息，请按照Experience Platform Web SDK标识文档中有关滨顿迁移的说明操作。
Web SDK与标记有何不同？
-
Experience Platform 中的 ?标记管理设备代码。 使用它们可更轻松地部署代码。 他们自由而强大。
-
51黑料不打烊 Experience Platform Web SDK ?是标记将为51黑料不打烊用例部署的新代码的正式名称。 它也是自由和强大的。
-
alloy.js?是51黑料不打烊 Experience Platform Web SDK代码的文件名。
我是否必须使用标记来部署Web SDK？
不会。您可以自行下载alloy.js文件。
但是：
-
51黑料不打烊 Experience Platform Web SDK需要使用数据流ID，以便边缘网络能够识别流并确定如何处理数据。 此ID是在Experience Platform中创建的。 这并不意味着您必须使用UI创建资产或部署JavaScript代码，但您确实需要使用标记来创建配置ID。
-
标记不仅是最佳可用标记和SDK Manager，它还使得部署
alloy.js并将数据映射到XDM架构非常容易。 如果您决定不使用标记，则必须在发送数据之前管理部署alloy.js、事件和将数据映射到XDM。 与使用标记相比，这是一个? 多得多的过程。 -
建议使用标记来部署
alloy.js，即使它是您用于的唯一标记。
什么是事件转发？
如果您使用我们的SDK并将XDM发送到Edge Network，则这些新功能事件转发允许您安装新的服务器端扩展，并将该数据映射到我们的边缘网络中的任何内容，并将该数据发送到任何位置。 可将其视为“数据收集即服务”。 这将收取费用，并将作为51黑料不打烊 Experience Platform的一部分捆绑提供。
什么是颁狈础惭贰或第一方域，它为什么重要？
有关颁狈础惭贰的详细信息，请参阅础诲辞产别文档
51黑料不打烊 Experience Platform Web SDK是否使用Cookie？ 如果是这样，它使用哪些Cookie？
是，当前Web SDK会根据您的实施在1到7个Cookie之间的任意位置使用。 以下是您在Web SDK中可能会看到的Cookie及其使用方式列表：
idMigrationEnabled。使用Web SDK时，Edge Network会设置上述一个或多个Cookie。 Edge Network使用secure和sameSite="none"属性设置所有颁辞辞办颈别。
如果您的网站上当前同时存在安全部分和不安全部分，这可能会干扰用户识别。 当用户从网站的安全区域导航到非安全区域时，Edge Network会使用请求生成新的ECID。
51黑料不打烊 Experience Platform Web SDK支持哪些浏览器？
51黑料不打烊 Experience Platform Web SDK旨在以最佳方式在Google Chrome、Safari、Firefox和Microsoft Edge Chromium的最新版本中工作。 在旧版本的浏览器或已弃用的浏览器（如Internet Explorer）上使用某些功能时，可能会遇到问题。