擴充事件追蹤

AEM Analytics可讓您追蹤網站上的使用者互動。 身為開發人員，您可能需要：

• 追蹤訪客與您的元件互動的方式。 這可以對自訂事件執行。
• 存取ContextHub中的值。
• 添加記錄回呼。

自訂事件

自訂事件會追蹤任何與頁面上特定元件可用性相關的項目。 這也包含範本特定的事件，因為page-component會被視為另一個元件。

追蹤頁面載入的自訂事件

這可以使用偽屬性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。

頁面載入後追蹤自訂事件

若要追蹤載入頁面後發生的事件（例如使用者互動），請使用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()%>

例如，使用下列定義時，按一下​跳至top​連結的使用者會引發兩個事件： 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中的值

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)

添加記錄回呼

使用函式CQ_Analytics.registerBeforeCallback(callback,rank)和CQ_Analytics.registerAfterCallback(callback,rank)註冊回呼前後。

這兩個函式都將函式作為第一個引數，將排名作為第二個引數，這決定了回呼的執行順序。

如果您的回呼傳回false，將不會執行執行鏈中後續的回呼。