A2J Analytics

Last updated June 2021

A2J Analytics

This information is provided for organizations and individuals who use A2J Author® to create A2J Guided Interviews® and/or self-host the A2J Viewer® on their own servers to better understand A2J Analytics. It is not intended to be our privacy policy or terms of use. End users should be directed to those policies if they have questions about the A2J Analytics.


Why add analytics to A2J Author at all?


    A2J Guided Interviews have been run over 7 million times since 2005. However, only 3 million documents have been generated. This discrepancy between assemblies and runs is not a new phenomenon. In the past, we have assumed that the 3 millions people who started an A2J Guided Interview but did not complete it did so intentionally. We assumed that the users were properly screened out of an A2J Guided Interview that was not right for their situation, or the users were asked a question that required information that they did not have on hand at the time, like a spouse’s Social Security number or the address of their child’s school. However, these were just assumptions. We could not see inside the user’s experience within the A2J Guided Interview. The A2J Viewer, the tool that plays the A2J Guided Interview for the end user, is a single page web application. That means commonly used analytical tools, like Google Analytics, can’t see within the A2J Guided Interview. Common analytical tools could tell the author that a user entered the interview and when they exited it, but not what happened in between those two data points. We needed to add our own internal analytics tool to A2J Author to move out of this data black hole.


Why Matomo?


Matomo (formerly known as Piwik) is an open source analytics platform. We chose to use Matomo, instead of other tools like Google Analytics, because Matomo is free and open sourced. It allows us to customize it and store the data on our own servers, ensuring user privacy protection. The information from user’s interactions with A2J Guided Interviews will reside on the CALI servers. CALI is The Center for Computer-Assisted Legal Instruction, A2J Author’s parent organization and a 501(c)(3) non-profit focused on legal education, technology, and access to justice. Because we can control the analytics engine ourselves, we know what is being tracked, why, and what algorithms are underlying the data. We’ve also used Matomo before. CALI has been running Matomo to track usage of our CALI lessons by law students for several years, so we have extensive experience integrating it into CALI products and interpreting the outcoming data.

What is being tracked?


Our A2J Analytics Tool will track the following user information:

  • IP address for geolocation purposes and to identify returning users, with the last two, least significant bytes deleated to anonymize the user

  • Time stamp of entering an interview

  • Time stamp and record of pages clicked

  • Time stamp and record of Learn Mores and Pop-ups clicked

  • Time stamp and record of exiting pages

  • Path through the interview

  • Device, operating system, and browser used to access the interview

  • Referral points from external websites (how the user got into the A2J Guided Interview)

  • Engagement level (how long did they stay on a page, how many times have they visited the interview, how many days since their last visit)


What we won’t be tracking:

  • User’s personal information (answers to any questions, name, address, etc)


What reports can be pulled?


Matomo allows authors to get a very robust look at how users are interacting with their A2J Guided Interviews. Authors can pull their own analytics reports about their interview. The authors request their custom analytics segments by going to the "Analytics" tab within their A2J Guided Interview and clicking the "Click Here to Request Your Analytics" button .

These reports include:

  • Number of visitors per interview

  • Whether the visitors are new or returning

  • Device type, model, brand, configuration, and resolutions

  • Operating systems and browsers used

  • Exit page titles

  • Outlinks

  • Regions

  • Pop-up Events

  • Learn More Events

  • Save and Exit Events

  • Resume Events


The reports will go out to the authors of the A2J Guided Interviews. The AuthorID is generated by the account of the last author to work on the interview before it was uploaded to the A2J Viewer. If organizations have hired consultants to do the development work for them and would like analytics on the interviews that were created for them, they can contact Tobias@cali.org to be added to the reporting group.



What do I have to do to use A2J Analytics?

The following section only applies to A2J Guided Interviews created before 2019. All interviews created after that automatically have the AuthorID attached to them. 

To enable A2J Analytics, all A2J Guided Interviews need to have a custom AuthorID added to them. This allows us to track the interviews and sort the data to specific authors. To enable the AuthorID to be placed on your interviews, all authors must open the interview in their A2JAuthor.org accounts and hit “Save” on the Pages Tab. This places the AuthorID into the xml of the interview. You will then need to re-upload the interview to LawHelp Interactive or download the interview and place it on your server if you are self-hosting the A2J Viewer.


If you are self-hosting the A2J Viewer on your own servers, you’ll need to download the latest version of the A2J Viewer and place that on your server. The A2J Viewer can be found on our Github Repository at https://github.com/CCALI/a2jviewer.




Contact A2J Author’s Project Manager, Jessica Frank, at jessica@cali.org