扩展事件跟踪 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，则不会执行执行链中后续的回调。