This article will cover the following frequently asked Analytics questions:
What is Turtl's definition of a read?
The total number of times a Turtl Doc was opened and the contact explored beyond the first page. If they don’t turn the first page within 30 minutes, they are counted as a bounce. If they come back after 30 minutes and take action, this is counted separately as a read.
What constitutes a contact when there is a contact personalization form?
Anyone who completes the personalization form and lands on the Turtl Doc itself, then explores beyond the first page.
How does Turtl calculate bounce rate?
If you want to be able to calculate the bounce rate yourself, here is how you can arrive at the bounce rate number as it appears on the dashboard from the reads analytics report.
As explained here, the formula we use is this one:
Math.round(((allReaders - readers) * 100) / allReaders) || 0;
allReaders can be obtained by applying the following filters to the reads Analytics report:
Filter out (remove) any rows that have a value of 0 in
is_initializedcolumn.Filter out (remove) any rows that have a value of 1 in
is_banned_ipcolumn.Only keep rows that have either both values in
source_iframeandsource_lightbox0 (meaning Doc is not embedded) or both values 1 (meaning Doc is embedded but opens in a Lightbox rather than in an iframe.). The reason is that we don’t include reads on Docs that are embedded in an iframe when calculating the bounce rates.After applying the above filters, identify the number of unique values in
reader_idcolumn to getallReaders.
To get readers, the steps are the same, but you would need to additionally remove any rows where count_read is 0 before counting the unique values.
Note: The contact no. on the dashboard may be higher because it includes contacts that have read the Turtl Doc embedded in the iframe. These reads are excluded from the bounce rate calculation.
How does Turtl calculate a bounce rate for embedded docs?
This depends on the type of embed.
Standard Turtl embed (opens in a lightbox)
The bounce rate is calculated the same way as in standalone Turtl Docs.
The bounce rate does not get calculated and does not contribute in any way to the overall bounce rate of the Doc. Please note that the embedded Doc can simultaneously get distributed as a standalone Doc or embedded via lightbox, which does contribute to the overall bounce rate.
The reads from the thus embedded Doc are counted towards the no. of reads for this Doc.
Why is my bounce rate 100%, when the dashboard shows an X number of reads
If your Doc is embedded on your website via an iframe, Turtl can only detect reads, but not bounces. In other words, we can't know how many people came on the website and landed on the Turtl Doc, we can only detect the people who have turned a page or otherwise engaged with the embedded Doc. For this reason, we exclude the reads from the overall bounce rate calculations, as it would skew the analytics for that Doc. We suggest embedding a Doc via lightbox if this metric is important to you.
Can Turtl block or filter certain IP addresses from the analytics?
Turtl can block analytics data for certain IPs or CIDR IP groups. This means that the data from blocked IPs is not displayed on the dashboard for the time during which IPs are blocked. By blocking IPs, we also filter the analytics data that was generated by the same IPs before they were blocked. The maximum number of IPs that can be blocked is 525,000.
Note: A high number of banned IPs may affect dashboard analytics performance.
Please turn to Customer Support with a list of IPs you wish to block and they will arrange it for you.
If I unblock certain IP addresses, will I be able to retrieve the analytics data?
Unblocking IPs will retrieve the data that was generated before blocking.
I have engaged with the Doc. Why is my IP not showing in Reads raw data download?
If you set the timeframe to the last 30 days and download the reads report CSV file you will get reads for today minus 30 days (so, excluding today).
If you also need today's reads (up to 5 minutes ago) you can select a custom timeframe and set today as an end date and you will have today's reads included in the downloaded CSV file.
Does Turtl collect analytics from logged-in Turtl users?
We do not collect analytics events for logged-in Turtl users.
If you log into Turtl via SSO and we match your email address with a corresponding one in the tenant, you will be logged in just like any other user and analytics will not be collected.
If we aren't able to match your email address with any of the users in the tenant, you will log in via SSO as a Guest. We do collect analytics events for Guests.
If you submit your email address via a form in a Turtl Doc, we will register and count you as a sign-up, regardless of whether we are collecting your analytics events or not.
How does Turtl process known contact and unknown contacts (guests)?
Note: Known contacts feature is available on our Professional and Unlimited plans. Please contact Customer Support if you want to upgrade your plan.
Both known contacts and guests create unique reader IDs (reader_id) when they access a Turtl Doc. If they access a Doc from the same browser/device, they will be matched against the existing ID, but if they access it from a different browser/device, a new reader_id will be created, so the same contact will actually be counted twice.
If some contacts are counted twice, the total number of (unique) contacts as displayed on the dashboard will be slightly higher than it actually is. This is usually not a problem, as contacts don’t usually view Docs in different browsers/devices.
Known contacts are additionally identified by their email address (reader_email), so when they log in with their email (which is the case in the above access settings), a reader_email entry is created. If they happen to log in from a different browser/device and enter the same email, it will be matched against the existing reader_email, so the total number of unique known contacts will be accurate.
Where does the no. of sign-ups on the dashboard come from?
The sign-ups can either come from a native Turtl form on the Back cover or Content pages or a third-party form on the Cover, Back cover, or Content pages. If a sign-up is created with the same email address multiple times, each sign-up will add up to this number. For a more in-depth analysis of sign-ups, please download Reads raw data.
What is the relationship between sign-ups and known contacts? Is the no. of known contacts equal to the number of sign-ups?
Known contacts can be identified through:
Sign-up form from Turtl or any third-party form integrated with Turtl
Lead capture URL
Email authentication (SSO or "Specific people only" access settings)
This means that the no. of known contacts may be higher than the no. of sign-ups.
It is also worth noting that once we have identified a known contact through a sign-up form, lead-capture URL, etc., we will be able to collect the known contact's analytics across other Turtl Docs they read, too, even if they weren't identified again through one of the above methods.
However, if the contact clears their browser cookies, we won’t be able to track known contact analytics until they complete a new sign-up form, or open a new lead capture URL.
Our Doc is internal, so why is the number of known contacts smaller than the number of all
contacts?
Users may create several unique reader_ids, which count towards contacts if they log in from different browsers or devices, but we only display unique email addresses as known contacts. This can be checked if you count unique reader_id entries against unique reader_email entries in the Reads raw data report.
I can see X number of sign-ups, but no known contacts. Why is that?
Being logged into Turtl will exclude contacts from being shown in the contacts section. If a signup comes from a list of banned IPs, they will not add to the number of signups.
What is a lead store?
This is where your known contact information is stored. If your CRM is integrated with Turtl, your CRM will show here. Turtl will appear if you don't have one set up. Internal means the contact had access to the Doc either through SSO or email authentication (Source will show as "Authentication" in this case).
What happens if a contact is identified via multiple channels, what will appear under "Store"?
If a person completes the form when they’re already identified (a known contact), the store that identified them first will be written in the “Known contacts” section.
Example:
First, a company sends a Turtl doc with lead capture URLs from their CRM, which already identifies a contact.
Then, the contact is prompted to fill out a Turtl form to sign up for a webinar, newsletter, etc.
In this case, the known contact's lead store is a CRM (Hubspot, Eloqua, etc. ) and not Turtl.
If a personalization or a Doc is deleted, does this remove their analytics from analytics dashboards?
Yes, it does! We don’t show analytics of removed personalizations and Doc analytics dashboards. If a Doc is deleted, we don’t show its analytics on the team dashboard.
Why is the Avg. Content Page time showing as n/a in the analytics?
You may encounter a situation where you can see a contact clicking on a URL in a Content page but the analytics are showing the page performance time as n/a for an individual contact.
The Avg. Content page time is shown as n/a if a contact lands on a Content page and does not flip that Content page or go to the Title page.
What does location "null" mean?
It means that our geoIP database did not know which country a certain IP belongs to.
How does Turtl calculate the Engagement score?
Engagement score is a metric that is available to measure both content and contacts.
It is calculated using three main normalized components:
Duration of time spent in content: Log-normalized time spent per page
% of Docs read: Adjusted ratio of pages read vs total pages
Document Events Emitted: Log-normalized number of events per page read
The engagement score = sum of the above components * 100
How does Turtl detect Bot Traffic?
Turtl includes built-in logic to automatically detect and exclude analytics events triggered by bots. If you still have concerns about possible bot traffic, please contact the Support Team, and we’ll be happy to help block any identified bot IPs.
Which user roles can view analytics?
Global Admins and Admins have full visibility across the account, including access to all workspaces and analytics for every Doc.
Workspace Owners, Publishers, Editors, and Analysts can view analytics only for Docs within the workspace they are assigned to.
Personalizers have access solely to analytics for Personalization Docs in their designated workspace.



