Notes:
This solution does not require Turtl to integrate with Marketo.
Custom events setup is available with either the Unlimited plan or Professional plan with the "Custom behavioral events" module added.
You can add Marketo’s custom JavaScript tracking code, called Munchkin, to your Turtl Doc(s) to send activity, e.g. page visits and clicked links, to Marketo when a reader interacts with a Turtl Doc.
The Munchkin code tracks all individuals who visit your Turtl Docs so you can react to their visits with automated marketing campaigns. Even anonymous visitors are tracked along with their IP addresses and other information. Once the visitor is identified, it becomes a person in Marketo and the history associated with the browser cookie is merged in.
How to find the tracking code in Marketo
You can generate your tracking code by selecting one of the three types of tracking codes.
What’s the process of getting the tracking code into Turtl
Once you have the tracking code, please send it to support@turtl.co and we will set it up as an extension for you, which can be toggled on/off on your Turtl Docs. You can also choose to apply this extension to all Turtl Docs automatically.
For reference, your tracking code will look something like the below example.
Note: CHANGE-ME
is to be replaced by your munchkin ID, e.g.: 000-ABC-000
.
What events does the tracking code collect by default?
"Visit Web Page" activities are sent to Marketo when a reader views a new webpage, in this case, a new page in a Turtl Doc. The activity contains information such as the Referrer URL, Webpage URL, and more.
"Clicked Link on Web Page" activities are sent to Marketo when a reader clicks a link on a webpage, this includes http/s, tel, and mailto links. Within Turtl Docs, this activity is generated for any internal or external link clicks, a click on the "Read On" button from a Title page, any external sharing links on the Doc or a widget, PDF Downloads, and more.
"Visit Web Page" and "Clicked Link on Web Page" activities are collected for both known and anonymous visitors within Marketo.
Please refer to Munchkin behavior section to learn more.
How do these events appear in Marketo?
1. On the Activity Log of a known visitor record
If a visitor is known to Marketo, the “Visit Web Page” and “Clicked Link on Web Page” activity appears within the Activity Log of the corresponding record in Marketo. When you click on each activity, you can see additional information about the activity. This information can be referenced and filtered within Smart Lists, Reports, and more e.g. you might want to create a Smart List of anyone who’s visited a certain page of a Turtl Doc.
Web activity is also captured for anonymous visitors. If they become known in Marketo later down the line (e.g. via a Marketo form fill or other method), a known visitor record is created and all historical web activity is associated to the new record.
Example Activity Log on a known visitor’s record
Example "Visit Web Page" Activity on a known visitor’s record
2. Web page activity in Reports
"Visit Web Page" and "Clicked Link on Web Page" activity can also be reported on within a Web Page Activity Report in Marketo. The report can be customized to show page activity for known or anonymous visitors.
How can we customize the tracking code to send custom Turtl events to Marketo?
If you are on Turtl’s Unlimited or Professional plan and have purchased the "Custom Behavioural Events" module, our engineering team can customize the standard Munchkin script to send through additional events from Turtl into Marketo that aren’t captured within the standard script.
The table below outlines the additional events we can send to Marketo. All event types will appear as "Visit Web page" activity type, with extra information logged under the "Query Parameters" section of an activity.
As part of the setup process, please let us know which of the below events you’d like to send. It’s a good idea to keep this as light as possible so you’re not overloaded with information.
Event name | What we’ll include within the Query Parameters |
Read Doc 1 minute |
|
Read Doc 2 minutes |
|
Read Doc 3 minutes |
|
Read Doc 4 minutes |
|
Read Doc 5 minutes |
|
Read Doc 8 minutes |
|
Read Doc 10 minutes |
|
Personalization Form Fill |
|
Poll Submit |
|
View Chart |
|
View Image |
|
View Map |
|
View PDF |
|
Watch Video |
|
Listen to Audio |
|
How do these custom events appear in Marketo?
Once the extension has been customized, the custom events will come through as "Visit Web Page" activities within Marketo, but we append additional information within the Query Parameters of the Activity Details.
Example of a custom event with additional content in the query parameters
The information within the Query Parameters can be used to create Smart Lists and Reports within Marketo to drill down into readers who have taken certain actions.
Example of a custom event being used to create a Smart List