A lead capture URL is a URL containing an anonymized unique contact token that is needed for Turtl to retrieve the reader's personal data from the CRM.

A lead capture URL is usually sent out by the customer to their contacts via a CRM.

Turtl can be combined with HubSpot to provide insight into how each individual reader is consuming your content. To do this, you will first need to configure the HubSpot integration and then send each reader their own lead capture URL (previously known as PURL - personalized URL) for your content.

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.

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

Highlight the text you wish to hyperlink and click the "Insert link" option. Then, 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

becomes:

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

To save it, right-click and save the image as a GIF. Then, upload the GIF to HubSpot using the image component. Once inserted, click on the GIF and locate the link section on the left-hand side.

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

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

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

https://team.turtl.co/story/turtl-times-spring-2018/?pid=61a1124f2aa065410cd511cd

The HubSpot tracking will therefore need to start with an "&" 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:

https://team.turtl.co/story/turtl-times-spring-2018/?lead[store]=hubspot&lead[id]={{ 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.

Select your recipients and send from HubSpot as usual.

Once your recipients have started reading your content, they will appear under "Known Contacts" within Turtl analytics.
​

Reader identification — whether via the HubSpot tracking code or the {{ contact.hs_object_id }} merge tag — works with HubSpot marketing emails only. It does not work with sales or 1:1 emails, such as sequences, emails sent directly from the CRM, or emails sent via the Sales extension.

This is not a limitation on Turtl's side. HubSpot marketing emails rewrite links and pass identity parameters directly on the destination URL, which is what allows Turtl to identify the reader.

Sales and 1:1 emails route links through HubSpot's click-tracking redirect domain without passing any identity parameters to the destination. This means there is nothing on the URL for Turtl — or any other destination — to identify the contact with.

The only reliable option is to use a pre-resolved lead capture URL — one that already contains the contact's actual Record ID instead of the {{ contact.hs_object_id }} merge tag — stored in a HubSpot contact property, and insert that property into your email.