이벤트 추적 확장 extending-event-tracking
AEM Analytics를 사용하면 웹 사이트에서 사용자 상호 작용을 추적할 수 있습니다. 개발자의 경우 다음을 수행해야 할 수 있습니다.
- 방문자가 구성 요소와 상호 작용하는 방법을 추적합니다. 이 작업은 사용자 지정 이벤트로 수행할 수 있습니다.
- ContextHub의 값에 액세스.
- 레코드 콜백 추가.
사용자 지정 이벤트 custom-events
사용자 지정 이벤트는 페이지의 특정 구성 요소 가용성에 따라 달라지는 모든 항목을 추적합니다. 페이지 구성 요소가 다른 구성 요소로 처리되므로 여기에는 템플릿별 이벤트도 포함됩니다.
페이지 로드 시 사용자 지정 이벤트 추적 tracking-custom-events-on-page-load
의사 특성 data-tracking
을(를) 사용하여 이 작업을 수행할 수 있습니다(이전 레코드 특성은 이전 버전과의 호환성을 위해 계속 지원됨). 모든 HTML 태그에 추가할 수 있습니다.
data-tracking
의 구문은
data-tracking="{'event': ['eventName'], 'values': {'key': 'value', 'nextKey': 'nextValue'}, componentPath: 'myapp/component/mycomponent'}"
두 번째 매개 변수로 페이로드라는 키-값 쌍을 원하는 수만큼 전달할 수 있습니다.
예제는 다음과 같습니다.
<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 함수를 사용하십시오.
CQ_Analytics.record({event: 'eventName', values: { valueName: 'VALUE' }, collect: false, options: { obj: this, defaultLinkType: 'X' }, componentPath: '<%=resource.getResourceType()%>'})
위치
-
events
은(는) 문자열 또는 문자열 배열입니다(여러 이벤트의 경우). -
values
에 추적할 모든 값이 포함되어 있습니다. -
collect
은(는) 선택 사항이며 이벤트와 데이터 개체가 포함된 배열을 반환합니다. -
options
은(는) 선택 사항이며 HTML 요소obj
및[defaultLinkType](https://microsite.omniture.com/t2/help/en_US/sc/implement/index.html#linkType)
과(와) 같은 링크 추적 옵션을 포함합니다. -
componentPath
은(는) 필수 특성이므로<%=resource.getResourceType()%>
(으)로 설정하는 것이 좋습니다.
예를 들어 다음 정의를 사용하면 사용자가 맨 위로 이동 링크를 클릭하면 두 개의 이벤트 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를 반환하는 경우 실행 체인에서 뒤에 오는 콜백이 실행되지 않습니다.