clickCollectionEnabled

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

clickCollectionEnabledが有効になっている場合、次のXDM要素にデータが自動的に入力されます。

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

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

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

いずれの場合も、xdm.web.webInteraction.nameは、クリックされた要素とその子孫に対して、次の順序で最初の空でない値を確認します。

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

実装

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
});

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

Web SDKでは、open Shadow DOM​要素内のリンクに対する自動クリックトラッキングがサポートされています。

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

シャドウ DOMには2つのタイプがあります。

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

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

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