Customizing form event tracking

Last update: May 3, 2023

CREATED FOR:

  • User
CAUTION
AEM 6.4 has reached the end of extended support and this documentation is no longer updated. For further details, see our technical support periods. Find the supported versions here.

Out of the box, the following events are tracked in an analytics enabled Adaptive Form:

EventAvailable variables
renderformName, formTitle, formInstance, source
abandonformName, formTitle, formInstance, panelName, panelTitle
saveformName, formTitle, formInstance, panelName, source
submitformName, formTitle, formInstance, source
errorformName, formTitle, fieldName, fieldTitle, panelTitle
helpformName, formTitle, fieldName, fieldTitle, panelTitle
fieldVisitformName, formTitle, fieldName, fieldTitle, panelTitle
panelVisitformName, formTitle, panelName, panelTitle

Customizing the field visit event timeout

On the default AEM form setup, if a user spends more than 60 seconds on a field, a fieldvisit event is triggered and the details of the field are sent to Adobe Analytics. You can customize the Field time tracking baseline under AEM Forms Analytics Configuration at AEM Configuration console (https://experienceleague.adobe.com/system/console/configMgr?lang=en) to increase or decrease the timeout limit.

Customizing the tracking events

You can modify the trackEventfunction available in /libs/afanalytics/js/custom.js file to customize the event tracking. Whenever an event that is being tracked occurs in an adaptive form, the trackEventfunction is called. The trackEvent function accepts two parameters: eventNameand variableValueMap.

You can evaluate value of *eventName *and variableValueMap arguments to change the tracking behavior of events. For example, you can choose to send the information to analytics server after a certain number of error events occur. You can also choose to perform any of the following customizations:

  • You can set a threshold time before sending the event.

  • You can maintain a state to decide action, for example, fieldVisit pushes a dummy event based on the timestamp of the last event.

  • You can use the pushEvent function to send the event to analytics server .

  • You can choose to not push the event to analytics server at all.

Sample

In the following example, state for the error event of each *fieldName attribute is maintained. *The event is sent to the analytics server only if an error occurs again.

case 'error':
        if(errorOccurred[variableValueMap.fieldName] == true) {
            pushEvent(eventName, variableValueMap)
        }
        errorOccurred[variableValueMap.fieldName] = true;
        break;