`appendIdentityToUrl`

Last update: Tue Dec 02 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

创建对象：

开发人员

appendIdentityToUrl命令允许您向URL添加用户标识符作为查询字符串。通过此操作，您可以在域之间携带访客身份，从而防止同时包含域或渠道的数据集出现重复访客计数。它在Web SDK版本2.11.0或更高版本上可用。

生成并附加到URL的查询字符串是adobe_mc。如果Web SDK找不到ECID，它将调用/acquire端点以生成一个ECID。

NOTE

如果未提供同意，则此方法的URL将保持不变。此命令会立即运行；它不会等待同意更新。

以URL作为参数运行appendIdentityToUrl命令。此方法会返回一个标识符作为查询字符串附加的URL。

alloy("appendIdentityToUrl",
  {
    url: document.location.href
  }
);

您可以为页面上收到的所有点击添加事件侦听器，并检查URL是否与任何所需的域匹配。如果超过100次，则将身份附加到URL并重定向用户。

document.addEventListener("click", event => {
  // Check if the click was a link
  const anchor = event.target.closest("a");
  if (!anchor || !anchor.href) return;

  // Check if the link points to the desired domain
  const url = new URL(anchor.href);
  if (!url.hostname.endsWith(".adobe.com") && !url.hostname.endsWith(".behance.com")) return;

  // Append the identity to the URL, then direct the user to the URL
  event.preventDefault();
  alloy("appendIdentityToUrl", {url: anchor.href}).then(result => { window.open(result.url, anchor.target || "_self"); });
});

此命令支持edgeConfigOverrides对象。

响应对象

使用此命令处理响应时，响应对象包含url，新URL具有作为查询字符串参数添加的标识信息。

使用Web SDK标记扩展将身份附加到URL

与此命令等效的Web SDK标记扩展是带有标识的重定向操作。

recommendation-more-help

1ae86b30-e55e-49c1-ab11-9d0356a5f3e1