モバイルから Web への ID とクロスドメイン ID の共有

概要

Adobe Experience Platform Web SDK は、訪問者 ID 共有機能をサポートしています。この機能により、モバイルアプリとモバイル Web コンテンツの間、およびドメイン間で、顧客がより正確にパーソナライズされたエクスペリエンスを配信できます。

ユースケース

モバイルアプリとモバイル Web サイト間で一貫したパーソナライゼーションを実現

衣料品会社は、興味に基づいて顧客のエクスペリエンスをパーソナライズし、WebViews を読み込むモバイルアプリケーションでパーソナライゼーションを正確に保ちたいと考えています。モバイル/Web 間 ID 共有機能を使用すると、アプリとモバイル Web コンテンツで同じ訪問者 ID を使用して、最も正確なオファーが顧客に提示されるようになります。その際に、 ECID をモバイル web URL に追加します。

ドメイン間で一貫したパーソナライゼーションを実現

複数のオンラインストアを持つ小売業者は、顧客の興味に基づいて、ドメインをまたいで買い物客のエクスペリエンスをパーソナライズしたいと考えています。 Web SDK のクロスドメイン ID 共有機能を使用すると、小売業者は、すべてのドメインにわたって、顧客の興味に基づいた正確なオファーを配信できます。

訪問者のアクティビティレポートの強化

ある技術小売業者は、訪問者のアクティビティレポートを、訪問者がモバイルアプリケーションからモバイル Web サイトまたは他のドメインに移動するタイミングに関する情報で改善したいと考えています。 Web SDK のクロスドメイン ID 共有機能を使用すると、マーケティングチームは Web プロパティをまたいで訪問者を正確に追跡し、アクティビティレポートを生成できます。

前提条件

モバイルから Web への ID とクロスドメイン ID の共有を使用するには、 Web SDK バージョン2.11.0以降。

Edge Network モバイル実装の場合、この機能は Edge ネットワークの ID バージョン 1.1.0(iOSおよび Android) 以降の拡張機能。

この機能は、 VisitorAPI.js バージョン 1.7.0 以降。

モバイルから Web への ID の共有

以下を使用： getUrlVariables からの API Edge ネットワークの ID 拡張機能を使用して、識別子をクエリパラメーターとして取得し、を開いたときに URL に関連付けることができます。 webViews.

Web SDK が受け入れるための追加設定は不要です ECID クエリー文字列の値。

クエリー文字列パラメーターには次が含まれます。

MCID:Experience CloudID (ECID)
MCORGID:Experience Cloud orgID それは orgID 設定済み Web SDK.
TS:5 分を超えないタイムスタンプパラメーター。

モバイルから Web への ID の共有では、 adobe_mc パラメーター。次の場合に adobe_mc パラメーターが存在し、有効な場合は、 ECID からのを呼び出すと、Edge ネットワークに対する最初のリクエストで id マップに自動的に追加されます。以降のすべての Edge ネットワークインタラクションでは、 ECID.

モバイルアプリから WebView に訪問者 ID を渡す方法について詳しくは、 WebViews の処理.

クロスドメイン ID 共有の場合、Web SDK バージョン2.11.0では、 appendIdentityToUrl コマンドを使用します。このコマンドを使用すると、 adobe_mc クエリー文字列パラメーター。

このコマンドは、1 つのプロパティを持つオブジェクトを受け入れます。 urlを返し、 url.

このコマンドは、同意の更新を待ちません。同意が提供されていない場合、URL は変更されずに返されます。

次の場合、 ECID が指定されていない場合、 /acquire エンドポイントが呼び出され、 ECID.

顧客が Web サイトでクロスドメイン ID 共有を実装する方法の例を以下に示します。

このコードは、ページ上のすべてのクリックに対してイベントリスナーを追加します。クリックが対応するドメインへのリンク ( この場合は adobe.com または behance.com) をクリックすると、ID が URL に追加され、そこにユーザーをリダイレクトします。

document.addEventListener("click", event => {
  const anchor = event.target.closest("a");
  if (!anchor || !anchor.href) {
    return;
  }
  const url = new URL(anchor.href);
  if (!url.hostname.endsWith("adobe.com") && !url.hostname.endsWith("behance.com")) {
    return;
  }
  event.preventDefault();
  alloy("appendIdentityToUrl", { url: anchor.href }).then(result => {
    document.location = result.url;
  });
});

タグ拡張機能の使用

次の Web SDK、 Tags 拡張機能を使用して、URL を介して渡された id を使用できます。

タグ拡張機能でモバイルから Web への ID とクロスドメイン ID の共有を使用するには、タグ拡張機能のバージョン2.12.0以降を使用する必要があります。

現在のページの ID を他のドメインと共有するには、新しいアクションを「 Web SDK Tags 拡張子。このアクションは、 コア — クリック イベントタイプと値比較条件。

以下の手順に従います。ここ次の設定を使用してルールを作成するには：

イベント設定:
- 拡張機能：Core
- イベントタイプ：クリック
- 選択 ユーザーが/特定の要素をクリックしたとき
- を セレクター: a[href]. このイベントは、 href プロパティ。
条件の設定
- 論理タイプ: 標準
- 拡張機能：コア
- 条件タイプ: 値の比較
- 左オペランド: %this.hostname%. これは、コア — クリックイベントを送信し、クリックされたリンクのホスト名に解決します。
- 演算子: Matches Regex
- 右オペランド:ID を共有するドメインに一致する正規表現を入力します。例えば、で終わるホスト名を持つリンクを照合するには、次のようにします。 adobe.com または behance.com、次の正規表現を使用します。 behance.com$|adobe.com$. リンクされたページには、 Web SDK または Visitor ID id を受け入れるためにインストールされました。
アクションの設定
- 拡張: Adobe Experience Platform Web SDK
- アクションタイプ: ID でリダイレクト
- インスタンス:インスタンスを選択します。ほとんどの場合、1 つのインスタンスのみが設定されます。複数のインスタンスがある場合、共有する ID を持つインスタンスを選択します。