擴充事件追蹤 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，則執行鏈結中後續的回呼將不會執行。