Custom analytics integrations

Learn how Turtl can send events directly to your central analytics platform

Radovan Vidović avatar
Written by Radovan Vidović
Updated over a week ago

Turtl comes with its own powerful analytics engine as standard. All reader behavior 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.

Note: This custom feature is included in our Unlimited plan and comes at an additional cost for the Professional plan. Don't hesitate to get in touch with your Account manager to discuss options.

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)

  • Logo click

  • Share Button Click - email

  • Share Button Click - <service> (Facebook, X (formerly Twitter), Linkedin, Xing)

  • PDF Zoom

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

Note: The above list of events is merely a suggestion. If there are other events you would find valuable for your business case, please include that in your request.

Did this answer your question?