概要

Adobe Experience Platform Web SDK 拡張機能は、Web プロパティからAdobe Experience Platform Edge ネットワークを介してAdobe Experience Cloudにデータを送信します。 拡張機能を使用すると、データを Platform にストリーミングしたり、ID を同期したり、顧客の同意シグナルを処理したり、コンテキストデータを自動的に収集したりできます。

このドキュメントでは、データ収集 UI で拡張機能を設定する方法について説明します。

拡張機能の設定

Platform Web SDK 拡張機能が既にプロパティ用にインストールされている場合は、データ収集 UI でプロパティを開き、「拡張機能」タブを選択します。 Platform Web SDK で、「設定」を選択します。

拡張機能をまだインストールしていない場合は、「カタログ」タブを選択します。 使用可能な拡張機能のリストから、Platform Web SDK 拡張機能を探し、「インストール」を選択します。

どちらの場合も、Platform Web SDK の設定ページが表示されます。 以下の節では、拡張機能の設定オプションについて説明します。

一般的な設定オプション

ページ上部の設定オプションは、Adobe Experience Platformに対し、データのルーティング先と、サーバーで使用する設定を指示します。

名前

Adobe Experience Platform Web SDK 拡張機能は、ページ上の複数のインスタンスをサポートします。 この名前は、タグ設定を使用して複数の組織にデータを送信する場合に使用します。

拡張機能の名前は、デフォルトで「alloy」に設定されます。 ただし、インスタンス名は任意の有効な JavaScript オブジェクト名に変更できます。

IMS 組織 ID

IMS 組織 ID は、Adobe時にデータの送信先となる組織です。 ほとんどの場合、自動入力されるデフォルト値を使用します。 ページに複数のインスタンスが存在する場合は、データの送信先となる 2 つ目の組織の値をこのフィールドに入力します。

エッジドメイン

Edge Domain は、Adobe Experience Platform拡張機能がデータの送受信をおこなうドメインです。 拡張機能では、実稼動用トラフィックにファーストパーティの CNAME を使用する必要があります。デフォルトのサードパーティドメインは開発環境で使用できますが、実稼動環境には適していません。ファーストパーティ CNAME の設定方法については、ここで説明します。

データストリーム

リクエストがAdobe Experience Platform Edge ネットワークに送信されると、データストリーム ID がサーバー側の設定の参照に使用されます。 Web サイトでコードを変更せずに、設定を更新できます。

詳しくは、datastreams のガイドを参照してください。

プライバシー

「プライバシー」セクションでは、Web サイトからのユーザーの同意シグナルを SDK がどのように処理するかを設定できます。 特に、他の明示的な同意設定が指定されていない場合に、ユーザーが想定するデフォルトの同意レベルを選択できます。 デフォルトの同意レベルは、ユーザーのプロファイルには保存されません。 次の表に、各オプションの内容を示します。

デフォルトの同意レベル 説明
In ユーザーが同意設定を提供する前に発生したイベントを収集します。
Out ユーザーが同意設定を提供する前に発生したイベントを破棄する。
保留中 ユーザーが同意設定を提供する前に発生したイベントをキューに入れる。 同意の環境設定を指定すると、指定した環境設定に応じてイベントが収集または破棄されます。
データ要素で指定 デフォルトの同意レベルは、定義する個別のデータ要素で決まります。 このオプションを使用する場合は、提供されたドロップダウンメニューを使用してデータ要素を指定する必要があります。

ビジネス運営に対する明示的なユーザーの同意が必要な場合は、「Out」または「Pending」を使用します。

ID

VisitorAPI からの ECID の移行

このオプションは、デフォルトでは有効になっています。この機能が有効な場合、SDK は AMCV Cookie と s_ecid Cookie を読み取り、Visitor.js で使用される AMCV Cookie を設定できます。 一部のページでは引き続き Visitor.js を使用している可能性があるので、この機能はAdobe Experience Platform Web SDK に移行する際に重要です。 これにより、SDK は引き続き同じ ECID を使用して、ユーザーが 2 人の異なるユーザーとして識別されないようにすることができます。

このオプションを使用すると、SDK は、ユーザー ID をサードパーティ Cookie に保存しようとします。 成功した場合、ユーザーは複数のドメイン間を移動する際に、各ドメインで別のユーザーとして識別されるのではなく、単一のユーザーとして識別されます。 このオプションが有効になっている場合、ブラウザーがサードパーティ Cookie をサポートしていない場合や、ユーザーがサードパーティ Cookie を許可しないように設定している場合、SDK は引き続き、ユーザー ID をサードパーティ Cookie に保存できません。 この場合、SDK は識別子をファーストパーティドメインにのみ保存します。

パーソナライゼーション

パーソナライズされたコンテンツが読み込まれる際にサイトで特定のパーツを非表示にする場合は、事前非表示のスタイルエディターで非表示にする要素を指定できます。 次に、提供されたデフォルトの事前非表示スニペットをコピーし、HTMLサイトの <head> 要素内に貼り付けます。

データ収集

コールバック関数

拡張機能で提供されるコールバック関数は、ライブラリ内では onBeforeEventSend 関数 とも呼ばれます。 この関数を使用すると、イベントをAdobe Edge Network に送信する前に、イベントをグローバルに変更できます。 この関数の使い方の詳細は こちら を参照してください。

クリックデータ収集

SDK は、リンククリック情報を自動的に収集できます。 デフォルトでは、この機能は有効ですが、このオプションを使用して無効にできます。 また、「リンク修飾子のダウンロード」テキストボックスにリストされたダウンロード式が含まれる場合、リンクにダウンロードリンクとしてラベルが付けられます。 Adobeには、デフォルトのダウンロードリンク修飾子がいくつか用意されていますが、これらはいつでも編集できます。

自動的に収集されたコンテキストデータ

デフォルトでは、SDK は、デバイス、Web、環境、場所コンテキストに関する特定のコンテキストデータを収集します。 収集した情報Adobeのリストを表示したい場合は、 ここ にあります。 このデータを収集しない場合や、特定のカテゴリのデータのみを収集する場合は、これらのオプションを変更できます。

詳細設定

エッジの基本パス

Adobe Edge Network とのやり取りに使用するベースパスを変更する必要がある場合は、このフィールドを使用します。 これは更新する必要はありませんが、ベータ版またはアルファ版に参加している場合は、Adobeからこのフィールドを変更するように求められる場合があります。

このページ