clickCollectionEnabled

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

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

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

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

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

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

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

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

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

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

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

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

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

Web SDK タグ拡張機能のクリックコレクションを有効または無効にします

タグを使用してこれらのアクションを実行する方法については、Web SDK拡張機能のドキュメントの ​ データ収集設定 ​ を参照してください。