擴充事件追蹤

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

注意

這些資訊基本上是通用的，但會使用 Adobe Analytics 以取得特定範例。

如需有關開發元件和對話方塊的一般資訊，請參閱 開發元件.

自訂事件

自訂事件會追蹤任何與頁面上特定元件可用性相關的專案。 這也包括範本專屬的事件，因為頁面元件會被視為另一個元件。

追蹤頁面載入上的自訂事件

您可以使用虛擬屬性進行此操作 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()%>

例如，使用下列定義，使用者按一下 跳至頂端 連結會造成兩個事件， 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)

注意

另請參閱完整的 ContextHub API參考

新增記錄回呼

使用函式登入回呼之前和之後 CQ_Analytics.registerBeforeCallback(callback,rank) 和 CQ_Analytics.registerAfterCallback(callback,rank).

這兩個函式都會將函式當作第一個引數，並將排名當作第二個引數，這會指定執行回呼的順序。

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

本頁內容