clickCollectionEnabled

clickCollectionEnabled 속성은 웹 SDK에서 자동으로 링크 데이터를 수집하는지 여부를 결정하는 부울입니다. 이 변수를 설정하지 않으면 기본값은 true입니다. 즉, 기본적으로 링크 추적 데이터가 자동으로 수집됩니다. 링크 데이터를 수동으로 추적하려는 경우 이 속성을 false(으)로 설정하는 것이 좋습니다.

clickCollectionEnabled이(가) 활성화되면 다음 XDM 요소가 자동으로 데이터로 채워집니다.

이 부울을 활성화하면 기본적으로 내부 링크, 다운로드 링크 및 종료 링크가 모두 자동으로 추적됩니다. Adobe 자동 링크 추적을 추가로 제어하려면 clickCollection 개체를 사용하는 것이 좋습니다.

열려 있는 Shadow DOM 요소 지원

웹 SDK은 열린 Shadow DOM 요소 내에 있는 링크에 대한 자동 클릭 추적을 지원합니다.

많은 최신 웹 사이트는 웹 구성 요소를 사용하여 재사용 가능한 캡슐화된 사용자 인터페이스 요소를 만듭니다. 이러한 구성 요소는 Shadow DOM 이라는 기술을 사용하여 내부 구조와 스타일을 나머지 페이지와 구분합니다.

Shadow DOM에는 두 가지 유형이 있습니다.

웹 SDK은 기본 문서의 링크에 대한 클릭과 마찬가지로 섀도 DOM 열기 내의 <a> 및 <area> 요소에 대한 클릭을 자동으로 추적합니다. 이렇게 하면 열려 있는 Shadow DOM을(를) 사용하는 웹 구성 요소 내의 링크 클릭이 분석 데이터에 포함됩니다. 구성 요소 외부에서 작동하는 JavaScript 코드에서 내부 구조가 숨겨져 있으므로 닫힌 섀도 DOM 내부의 클릭은 추적되지 않습니다.

자동 링크 추적 논리

웹 SDK은 onClick 특성이 없는 경우 <a> 및 <area> HTML 요소에 대한 모든 클릭 수를 추적합니다. 문서에 연결된 capture 클릭 이벤트 수신기로 클릭 수를 캡처합니다. 유효한 링크를 클릭하면 다음 논리가 순서대로 실행됩니다.

모든 경우에 xdm.web.webInteraction.name은(는) 링크 텍스트 레이블로 설정되고 xdm.web.webInteraction.URL은(는) 링크 대상 URL로 설정됩니다. 링크 이름도 URL로 설정하려면 clickCollection 개체에서 filterClickDetails 콜백을 사용하여 이 XDM 필드를 재정의할 수 있습니다.

웹 SDK 태그 확장을 사용하여 자동 링크 추적 활성화 tag-extension

이 변수는 태그 확장에 의해 자동으로 관리되므로 명시적으로 설정할 필요가 없습니다. 태그 확장을 구성할 때 다음 중 하나를 선택하면 해당 링크 추적 데이터가 수집됩니다.

자세한 내용은 clickCollection을(를) 참조하십시오.

웹 SDK JavaScript 라이브러리를 사용하여 자동 링크 추적 활성화 library

configure 명령을 실행할 때 clickCollectionEnabled 부울을 설정합니다. 웹 SDK을 구성할 때 이 속성을 생략하면 기본적으로 true이(가) 됩니다. xdm.web.webInteraction.type 및 xdm.web.webInteraction.value을(를) 수동으로 설정하려면 이 값을 false(으)로 설정하십시오.

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