`appendIdentityToUrl`

最終更新日： 2026年5月24日

トピック：
{"id":"e08599ea-8888-4294-ba74-3ba0a7762a46"}

作成対象：

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

appendIdentityToUrl コマンドを使用すると、ユーザーIDをクエリ文字列としてURLに追加できます。このアクションにより、ドメイン間で訪問者のIDを転送し、ドメインまたはチャネルの両方を含むデータセットの訪問者数が重複するのを防ぐことができます。 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が目的のドメインと一致するかどうかを確認できます。その場合は、IDを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 が含まれ、ID情報を含む新しいURLがクエリ文字列パラメーターとして追加されます。

Web SDK タグ拡張機能を使用してURLにIDを追加する

このコマンドと同等のWeb SDK タグ拡張機能は、ID付きリダイレクトアクションです。

recommendation-more-help

experience-platform-help-collection