appendIdentityToUrl

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

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

Web SDK拡張機能を使用して URL に ID を追加 extension

URL への ID の追加は、Adobe Experience Platform Data Collection タグインターフェイスのルール内のアクションとして実行されます。

このコマンドは、通常、クリックをリッスンして目的のドメインを確認する特定のルールと共に使用されます。

Web SDK JavaScript ライブラリを使用して URL に ID を追加

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 => {document.location = result.url;});
});

応答オブジェクト

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