Turtl allows you to track analytics for each individual reader when your Turtl Doc is sent out via email from HubSpot. The following steps guide you through the process:

1. Ensure HubSpot integration is configured for your account

This can be done by following our guide. If you are unsure or need help, contact support@turtl.co or click the chat icon in the bottom right.

2. Create your email in HubSpot

Use the standard HubSpot email creation tools to create your email as normal.

When you come to add a link to your Turtl Doc, click the link option and insert your Turtl Doc URL as usual, but add the following to the end of the URL
?lead[store]=hubspot&lead[id]={{ contact.hs_object_id }}

For example, the Turtl Doc URL:



https://team.turtl.co/story/turtl-times-spring-2018?lead[store]=hubspot&lead[id]={{ contact.hs_object_id }}

Important note: What if you want to add HubSpot tracking to a personalized URL, or you also want to add UTM codes to the same URL? Just follow the below structure.

The first thing added to the end of your URL needs to start with a ‘?’. Any subsequent additions need to start with a ‘&’.

A personalized URL already has an addition after the normal Doc URL. See an example below.


The HubSpot tracking will therefore need to start with a ‘&’ instead. For example:

https://team.turtl.co/story/turtl-times-spring-2018/?pid=61a1124f2aa065410cd511cd&lead[store]=hubspot&lead[id]={{ contact.hs_object_id }}

Adding UTM tags works in the same way. Say you wanted to add two UTM tags, utm_source=linkedin and utm_campaign=primary_campaign. Adding them to the non-personalized example above would become:


contact.hs_object_id }}&utm_source=linkedin&utm_campaign=primary_campaign

Or, the personalized example from above would become:

https://team.turtl.co/story/turtl-times-spring-2018/?pid=61a1124f2aa065410cd511cd&lead[store]=hubspot&lead[id]={{ contact.hs_object_id }}&utm_source=linkedin&utm_campaign=primary_campaign

You can read more about UTM tags in our article here.

4. Send your email as usual

Select your recipients and send from HubSpot as usual.

5. Check your Turtl analytics

Once your recipients have started reading your content, they will appear under Known Readers within Turtl analytics. You will also see the following which indicates how the known reader was established.

Important note: Sending out test emails via Hubspot or using the Hubspot Email Preview tool can result in 'no email / unknown' reader data appearing within Turtl analytics. This can be removed if required, just contact the support team via live chat or email support@turtl.co.

Did this answer your question?