`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。如果網頁SDK找不到ECID，它會呼叫/acquire端點以產生一個。

NOTE

如果尚未提供同意，則傳回此方法的URL不會變更。此命令會立即執行；不會等待同意更新。

以URL作為引數執行appendIdentityToUrl命令。此方法會傳回URL，並附加識別碼作為查詢字串。

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

您可以為頁面上收到的所有點按新增事件接聽程式，並檢視URL是否符合任何需要的網域。如果包含，則將身分附加至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已新增為查詢字串引數。

使用網路SDK標籤擴充功能將身分附加至URL

與此命令等同的Web SDK標籤擴充功能是使用身分識別的重新導向。

recommendation-more-help

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