Adobe Experience PlatformWeb SDK扩展

AEP Web SDK Extension通过Adobe Experience Platform边缘网络从Web属性向Adobe Experience Cloud发送数据。 Adobe Experience PlatformWeb SDK扩展允许将数据流化到平台、同步身份、选择加入并自动收集上下文数据。

配置AEP Web SDK扩展

本节提供配置Adobe Experience PlatformWeb SDK扩展时可用选项的参考。

如果尚未安装Adobe Experience PlatformWeb SDK扩展，请打开您的属性，选择​Extensions > Catalog，将指针悬停在Adobe Experience PlatformWeb SDK扩展上，然后选择​Install。

要配置扩展，请打开​Extensions​选项卡，将指针悬停在扩展上，然后选择​Configure。

实例名称

AEP Web SDK扩展支持页面上的多个实例。 可以利用这一点来通过单个 Adobe Experience Platform Launch 配置向多个组织发送数据。Name 默认为 alloy。但是，您可以将实例名称更改为任何有效的 JavaScript 对象名称。Adobe Experience Platform 扩展要求每个实例具有不同的 Config ID 和不同的 Organization ID。

Config ID

Config ID 告诉 Adobe Experience Platform 应该将数据路由到何处以及应该在服务器上使用什么配置。这是 Adobe Experience Platform 扩展正常工作所必需的。您可以联系客户关怀获取配置 ID。

Organization ID

Organization ID 是要将数据发送到的 Adobe 组织。大多数情况下，您应使用自动填充的默认值。当页面上有多个实例时，使用要向其发送数据的第二个组织的值填充该实例。

Edge Domain

Edge Domain 是 Adobe Experience Platform 扩展发送和接收数据的域。该扩展要求您对生产流量使用第一方 CNAME。默认的第三方域适用于开发环境，但不适合生产环境。此处列出了有关如何设置第一方 CNAME 的说明。

Enable Errors

默认情况下，如果该扩展存在错误，它会将错误记录到控制台。如果要隐藏生产环境中的错误，可取消选中 Enable Errors 复选框。在 Platform Launch 中打开调试时，仍会输出错误。

Enable Opt-in

如果启用​Enable Opt-in，则AEP Web SDK扩展可以保持点击，直到收到选择加入。 此扩展会显示用于设置选择加入首选项的操作。

Enable Migrate ECID

AEP Web SDK扩展使用新cookie存储ECID。 出于迁移目的，此设置支持新 Cookie 与旧 Cookie 之间的兼容性。Adobe 强烈建议启用此功能，除非您的现有访客均未使用 ECID。

Use 3rd Party Cookies

Adobe Experience Platform 将始终在第一方域中存储 Cookie。此选项使您除了使用第一方域中的 Cookie 之外，还能够使用在 demdex.net 上设置的第三方 Cookie。当用户在多个域之间移动时，此选项会很有用。这将禁用对 demdex.net 的调用。

Context

此扩展会自动收集有关请求上下文的信息（例如，有关 URL 和浏览器的详细信息）。可通过取消选择特定上下文来禁用此选项。

• web - 有关网页的详细信息（如 URL、反向链接等）。
• device - 有关设备的详细信息（如屏幕方向、屏幕高度和屏幕宽度）。
• environment - 有关计算环境的信息（浏览器、连接等）
• location - 有关用户位置的有限信息

操作类型

发送事件

向 Adobe Experience Platform 发送事件，以便 Adobe Experience Platform 可以收集您发送的数据并根据此信息执行操作。必须选择一个实例（如果您有多个实例）。如果事件发生在页面加载开始时或在单个页面应用程序中的视图更改期间，请选择 Occurs at the start of a view。

您要发送的任何数据均可通过 XDM Data 字段发送。这应该是符合 XDM 架构的 JSON 对象。此对象可以在页面上创建，也可以通过 Custom Code Data Element 创建。

设置同意

在您收到用户的同意后，必须将其通知AEP Web SDK。 您可以使用“设置同意”操作类型执行此操作。 目前，支持两种类型的标准："Adobe"和"IAB TCF" 如果使用Adobe标准，您当前可以将同意设置为“输入”、“输出”，或者您可以使用数据元素提供该同意。 如果使用IAB TCF标准，请提供要使用的版本和值，以及有关GDPR的其他信息。

在此操作中，您还会获得一个可选字段，用于包含身份映射，以便在收到同意后可以同步身份。 当同意被配置为“待定”时，这可能很有用，因为同意呼叫可能是第一个要触发的呼叫。

重置事件合并ID

如果要在页面上重置事件合并ID，则可以通过此操作来重置。 要重置ID，您需要选择要重置的合并ID，并根据需要触发操作。

数据元素类型

事件合并ID

此数据元素在使用时提供事件合并ID。 此数据元素无需配置。 提供的访客元素在事件离开页面或使用“重置合并ID”操作类型之前保持不变。

身份映射

标识映射数据元素允许您根据您指定的其他数据元素或其他值创建标识。 您创建的所有身份都必须绑定到相应的命名空间。 此数据元素提供一个下拉列表，其中显示所有默认命名空间以及您创建的任何数据。

XDM对象

您发送到Adobe Experience PlatformWeb SDK的任何数据都应采用XDM格式。 使用XDM对象数据元素可更轻松地格式化数据。 首次打开此数据元素时，请选择正确的Adobe Experience Platform沙箱和模式。 选择模式后，您将看到模式的结构，您可以轻松填写。

请注意，打开模式的某些字段（如web.webPageDetails.URL）时，会自动收集某些项目。 即使自动收集了多个项目，您也可以根据需要覆盖任意项目。 所有值都可以手动填写或使用其他数据元素。