Gebeurtenistracking uitbreiden extending-event-tracking

Met AEM Analytics kunt u gebruikersinteractie op uw website volgen. Als ontwikkelaar moet u mogelijk:

Aangepaste gebeurtenissen custom-events

Aangepaste gebeurtenissen volgen alles wat afhankelijk is van de beschikbaarheid van een specifieke component op de pagina. Dit omvat ook gebeurtenissen die sjabloonspecifiek zijn, aangezien de pagina-component als een andere component wordt behandeld.

Aangepaste gebeurtenissen bijhouden bij laden van pagina tracking-custom-events-on-page-load

Dit kan worden gedaan gebruikend pseudo-attribuut data-tracking (het oudere verslagattribuut wordt nog gesteund voor achterwaartse verenigbaarheid). U kunt dit toevoegen aan elke HTML-tag.

De syntaxis voor data-tracking is

U kunt elk aantal sleutel-waardeparen als tweede parameter overgaan, die nuttige lading wordt genoemd.

Een voorbeeld zou als kunnen kijken:

<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>

Bij het laden van de pagina worden alle data-tracking -kenmerken verzameld en toegevoegd aan de gebeurteniswinkel van de ContextHub, waar ze kunnen worden toegewezen aan Adobe Analytics-gebeurtenissen. Gebeurtenissen die niet zijn toegewezen, worden niet bijgehouden door Adobe Analytics. Zie Verbindend met Adobe Analyticsvoor meer details over kaartgebeurtenissen.

Aangepaste gebeurtenissen bijhouden na laden van pagina tracking-custom-events-after-page-load

Als u gebeurtenissen wilt bijhouden die plaatsvinden nadat een pagina is geladen (zoals gebruikersinteracties), gebruikt u de functie CQ_Analytics.record JavaScript:

Wanneer

Bijvoorbeeld, met de volgende definitie, zal een gebruiker die Jump aan top verbinding klikt de twee gebeurtenissen, jumptop en headlineclick veroorzaken om worden in brand gestoken:

<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>

Toegang tot Waarden in ContextHub accessing-values-in-the-contexthub

De ContextHub JavaScript API heeft een getStore(name) functie die de gespecificeerde opslag, indien beschikbaar terugkeert. De opslag heeft een getItem(key) functie die de waarde van de gespecificeerde sleutel, indien beschikbaar terugkeert. Met de functie getKeys() kunt u een array met gedefinieerde sleutels voor de specifieke opslag ophalen.

U kunt op de hoogte worden gesteld van waardewijzigingen in een winkel door een functie te binden met de functie ContextHub.getStore(name).eventing.on(ContextHub.Constants.EVENT_STORE_UPDATED, handler, selector, triggerForPastEvents) .

De beste manier om van aanvankelijke beschikbaarheid van ContextHub op de hoogte te worden gebracht is de ContextHub.eventing.on(ContextHub.Constants.EVENT_ALL_STORES_READY, handler, selector, triggerForPastEvents); functie te gebruiken.

Extra gebeurtenissen voor ContextHub:

Alle winkels klaar:

ContextHub.eventing.on(ContextHub.Constants.EVENT_ALL_STORES_READY, handler, selector, triggerForPastEvents);

Opslagspecifiek:

ContextHub.getStore(store).eventing.on(ContextHub.Constants.EVENT_STORE_READY, handler, selector, triggerForPastEvents)

Recordcallbacks toevoegen adding-record-callbacks

Voor en na callbacks worden geregistreerd met de functies CQ_Analytics.registerBeforeCallback(callback,rank) en CQ_Analytics.registerAfterCallback(callback,rank) .

Beide functies nemen een functie als eerste argument en een rang als tweede argument, die de orde dicteert dat callbacks worden uitgevoerd.

Als uw callback vals terugkeert, zullen de callbacks die in de uitvoeringsketen volgen niet worden uitgevoerd.