clickCollectionEnabled

clickCollectionEnabled プロパティは、Web SDKがリンクデータを自動的に収集するかどうかを指定するブール値です。 この変数を設定しない場合、デフォルト値は true になります。つまり、リンクトラッキングデータはデフォルトで自動的に収集されます。 このプロパティを false に設定すると、リンクデータを手動で追跡する場合に便利です。

clickCollectionEnabled が有効な場合、次の XDM 要素が自動的にデータを入力します。

このブール値を有効にすると、デフォルトで内部リンク、ダウンロードリンク、離脱リンクがすべて自動的に追跡されます。 自動リンクトラッキングをより詳細に制御する場合、Adobeでは clickCollection オブジェクトを使用することをお勧めします。

オープンな Shadow DOM 要素のサポート

Web SDKは、開いたシャドウ DOM 要素内のリンクの自動クリックトラッキングをサポートしています。

最新の多くの Web サイトでは、Web コンポーネントを使用して、再利用可能でカプセル化されたユーザーインターフェイス要素を構築しています。 これらのコンポーネントでは、多くの場合、シャドウ DOM と呼ばれるテクノロジーを使用して、内部構造とスタイルをページの他の部分から分離します。

シャドウ DOM には次の 2 種類があります。

Web SDKは、メインドキュメント内のリンクの場合と同様に、開いたシャドウ DOM 内の <a> 要素と <area> 要素のクリック数を自動的に追跡します。 これにより、開いている Shadow DOM を使用して web コンポーネント内でクリックされたリンクが、分析データに確実に含まれます。 閉じられたシャドウ DOM 内のクリックは、その内部構造がコンポーネントの外部で動作するJavaScript コードに対して非表示になっているので、追跡されません。

自動リンクトラッキングロジック

Web SDKは、<a> および <area> HTML要素に対するすべてのクリックを追跡します（onClick 属性がない場合）。 クリックは、ドキュメントに添付された capture クリックイベントリスナーでキャプチャされます。 有効なリンクをクリックすると、次のロジックが順に実行されます。

いずれの場合も、xdm.web.webInteraction.name はリンクテキストラベルに設定され、xdm.web.webInteraction.URL はリンク先の URL に設定されます。 URL へのリンク名を設定する場合は、clickCollection オブジェクトで filterClickDetails コールバックを使用して、この XDM フィールドを上書きできます。

Web SDK タグ拡張機能を使用した自動リンクトラッキングの有効化 tag-extension

この変数は、タグ拡張機能によって自動的に管理されるので、明示的に設定する必要はありません。 タグ拡張機能の設定時に次のいずれかを選択すると、該当するリンクトラッキングデータが収集されます。

詳細は、clickCollection を参照してください。

Web SDK JavaScript ライブラリを使用して自動リンクトラッキングを有効にします library

configure コマンドを実行するときは、clickCollectionEnabled のブール値を設定します。 Web SDKの設定時にこのプロパティを省略した場合、デフォルトは true になります。 xdm.web.webInteraction.type と xdm.web.webInteraction.value を手動で設定する場合は、この値を false に設定します。

alloy(configure, {
  datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
  orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg",
  clickCollectionEnabled: false
});