appendIdentityToUrl

appendIdentityToUrl コマンドを使用すると、ユーザー識別子をクエリ文字列として URL に追加できます。 このアクションにより、ドメイン間で訪問者の ID を持ち歩き、ドメインまたはチャネルの両方を含むデータセットに対して、重複した訪問者数を防ぐことができます。 Web SDK バージョン 2.11.0 以降で使用できます。

生成され、URL に追加されたクエリ文字列は adobe_mc です。 Web SDKで ECID が見つからない場合は、/acquire エンドポイントを呼び出して ECID を生成します。

URL をパラメーターとして使用して appendIdentityToUrl コマンドを実行します。 メソッドは、識別子がクエリ文字列として追加された URL を返します。

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

ページ上で受け取ったすべてのクリックに関するイベントリスナーを追加し、URL が目的のドメインに一致するかどうかを確認できます。 追加される場合は、URL に ID を追加し、ユーザーをリダイレクトします。

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 オブジェクトをサポートします。

応答オブジェクト

このコマンドを使用して ​ 応答を処理 ​ する場合、応答オブジェクトには、ID 情報がクエリ文字列パラメーターとして追加された url という新しい URL が含まれます。

Web SDK タグ拡張機能を使用した URL への ID の追加

このコマンドと同等の web SDK タグ拡張機能は、「ID を使用してリダイレクト ​ アクション ​ です。