Turtl comes with its own powerful analytics engine as standard. All reader behaviour is tracked here and made available for interrogation via our user-friendly dashboards.

However, it is also possible to send some (or all, if you wish) of your reader analytics data straight to your existing external analytics platform. This guide outlines how this works and the types of data that can be sent.

Analytics events in Turtl

Turtl's analytics uses an events-based system, so whenever a reader takes an action within a doc, a corresponding event is emitted. The following actions trigger an event:

  • Turning a page

  • Opening the Immerse level

  • Closing the Immerse level

  • Filling in a form

  • Following an external link 

  • Following an internal link

  • Answering a poll

  • Zooming an image

  • Zooming a map

  • Zooming a chart

  • Listening to audio

  • Watching a video clip

  • Clicking a share button

  • Clicking the logo

  • Going to fullscreen mode

  • Opening the "Contents" menu

  • Downloading the PDF version

  • Read a Doc at least x minute(s)

Any event listed above can be sent directly to your external analytics platform in real-time, provided it has a browser-based Javascript API which can be run from within a Turtl reading experience.

Each event Turtl sends can include additional context data (e.g. the URL in the case of a link being clicked, or the question and answer given in the case of a poll response).

Getting started

Custom development work is required to implement this solution. If you are interested in adding a custom analytics integration for your Turtl instance, please speak to your Customer Success Manager or contact support@turtl.co.

Did this answer your question?