이벤트 추적 확장 extending-event-tracking

AEM Analytics를 사용하면 웹 사이트에서 사용자 상호 작용을 추적할 수 있습니다. 개발자의 경우 다음을 수행해야 할 수 있습니다.

사용자 지정 이벤트 custom-events

사용자 지정 이벤트는 페이지의 특정 구성 요소 가용성에 따라 달라지는 모든 항목을 추적합니다. 페이지 구성 요소가 다른 구성 요소로 처리되므로 여기에는 템플릿별 이벤트도 포함됩니다.

페이지 로드 시 사용자 지정 이벤트 추적 tracking-custom-events-on-page-load

이 작업은 의사 특성을 사용하여 수행할 수 있습니다 data-tracking 이전 레코드 속성은 이전 버전과의 호환성을 위해 계속 지원됩니다. 모든 HTML 태그에 추가할 수 있습니다.

구문 data-tracking 은(는)

두 번째 매개 변수로 페이로드라는 키-값 쌍을 원하는 수만큼 전달할 수 있습니다.

예제는 다음과 같습니다.

<span data-tracking="{event:'blogEntryView',
                                values:{
                                   'blogEntryContentType': 'blog',
                                   'blogEntryUniqueID': '<%= xssAPI.encodeForJSString(entry.getId()) %>',
                                   'blogEntryTitle': '<%= xssAPI.encodeForJSString(entry.getTitle()) %>',
                                   'blogEntryAuthor':'<%= xssAPI.encodeForJSString(entry.getAuthor()) %>',
                                   'blogEntryPageLanguage':'<%= currentPage.getLanguage(true) %>'
                                },
                                componentPath:'myapp/component/mycomponent'}">
</span>

페이지 로드 시, 모두 data-tracking 특성이 수집되고 ContextHub의 이벤트 저장소에 추가되어, Adobe Analytics 이벤트에 매핑될 수 있습니다. 매핑되지 않은 이벤트는 Adobe Analytics에서 추적되지 않습니다. 다음을 참조하십시오 Adobe Analytics에 연결 를 참조하십시오.

페이지 로드 후 사용자 지정 이벤트 추적 tracking-custom-events-after-page-load

페이지가 로드된 후 발생하는 이벤트(예: 사용자 상호 작용)를 추적하려면 CQ_Analytics.record JavaScript 함수:

위치

예를 들어, 다음 정의를 사용하면 사용자가 위로 이동 링크로 인해 두 이벤트가 발생하고 jumptop 및 headlineclick, 실행할 날짜:

<h1 data-tracking="{event: 'headline', values: {level:'1'}, componentPath: '<%=resource.getResourceType()%>'}">
  My Headline <a href="#" onclick="CQ_Analytics.record({event: ['jumptop','headlineclick'],  values: {level:'1'}, componentPath: '<%=resource.getResourceType()%>'})">Jump to top</a>
</h1>

ContextHub의 값 액세스 accessing-values-in-the-contexthub

ContextHub JavaScript API에는 getStore(name) 지정된 스토어를 반환하는 함수입니다(사용 가능한 경우). 그 가게는 getItem(key) 지정된 키의 값을 반환하는 함수입니다(사용 가능한 경우). 사용 getKeys() 함수 특정 저장소에 대해 정의된 키 배열을 검색할 수 있습니다.

를 사용하여 함수를 바인딩하여 저장소의 값 변경 내용에 대한 알림을 받을 수 있습니다. ContextHub.getStore(name).eventing.on(ContextHub.Constants.EVENT_STORE_UPDATED, handler, selector, triggerForPastEvents) 함수.

ContextHub의 초기 가용성을 알리는 가장 좋은 방법은 ContextHub.eventing.on(ContextHub.Constants.EVENT_ALL_STORES_READY, handler, selector, triggerForPastEvents); 함수.

ContextHub에 대한 추가 이벤트:

모든 스토어가 준비됨:

ContextHub.eventing.on(ContextHub.Constants.EVENT_ALL_STORES_READY, handler, selector, triggerForPastEvents);

특정 저장소:

ContextHub.getStore(store).eventing.on(ContextHub.Constants.EVENT_STORE_READY, handler, selector, triggerForPastEvents)

레코드 콜백 추가 adding-record-callbacks

함수를 사용하여 콜백을 등록하기 전과 등록하기 후 CQ_Analytics.registerBeforeCallback(callback,rank) 및 CQ_Analytics.registerAfterCallback(callback,rank).

두 함수 모두 콜백이 실행되는 순서를 지정하는 첫 번째 인수로 함수를 사용하고 두 번째 인수로 등급을 사용합니다.

콜백이 false를 반환하는 경우 실행 체인에서 뒤에 오는 콜백이 실행되지 않습니다.