启用跨域访客配置文件
Platform Web SDK支持访客ID共享功能,使客户能够在您的域中更准确地提供个性化体验。 此功能允许您跨域提供一致的个性化,并提高访客活动报告的准确性,而无需依赖第三方Cookie。
先决条件
要使用跨域ID共享,您必须使用Platform Web SDK版本2.11.0或更高版本。 此功能还与VisitorAPI.js版本1.7.0或更高版本兼容。
跨域ID共享的工作方式是将特殊的adobe_mc
查询字符串参数附加到目标域的URL。 此参数用于指定访客ID,而不是生成新ID或使用现有ID。
目标域必须使用任一跨域ID共享库来处理adobe_mc
参数并正确共享访客ID。
方法比较
在实施之前,请先确定现有实施是否使用visitor.appendVisitorIDsTo()
函数。 应更新使用此函数的任何自定义代码,以使用新的appendIdentityToUrl
Web SDK命令。
VisitorAPI.js
平台Web SDK
visitor.appendVisitorIDsTo(*url*)
alloy("appendIdentityToUrl", { url: *url* })
使用appendIdentityToURL
命令
对于跨域ID共享,Web SDK版本2.11.0添加了对appendIdentityToUrl
命令的支持。 使用此命令时,会生成adobe_mc
查询字符串参数。
该命令接受具有一个属性url
的对象,并返回具有属性URL的对象。
此命令不等待任何同意更新。 如果未提供同意,则返回的URL将保持不变。
如果未提供ECID,则调用/acquire
端点以生成ECID。
以下是如何实施跨域ID共享的示例。
此代码会为页面上的所有点击添加一个事件侦听器。 如果单击位于匹配域的链接上(在本例中为adobe.com或behance.com),则会将标识添加到URL并将用户重定向到该处。
document.addEventListener("click", event => {
const anchor = event.target.closest("a");
if (!anchor || !anchor.href) {
return;
}
const url = new URL(anchor.href);
if (!url.hostname.endsWith("adobe.com") && !url.hostname.endsWith("behance.com")) {
return;
}
event.preventDefault();
alloy("appendIdentityToUrl", { url: anchor.href }).then(result => {
document.location = result.url;
});
});
TIP
使用标记功能(以前称为Launch)实施Web SDK时,无需自定义代码即可实现跨域ID共享。 有关详细信息,请参阅专用文档。
NOTE
Platform Web SDK还支持在本机移动设备应用程序用例中进行移动设备到Web ID共享。 有关详细信息,请参阅有关移动到Web和跨域ID共享的专用文档。
接下来,了解如何更新受众和配置文件脚本以确保与Platform Web SDK兼容。
NOTE
我们致力于帮助您成功完成从at.js到Web SDK的Target迁移。 如果您在迁移过程中遇到障碍或觉得本指南中缺少关键信息,请在此社区讨论中发帖让我们知道。
recommendation-more-help
a69e1b51-9545-4d8a-822d-319242c29110