Skip to main content
Marketo tracking code and custom events

Using the Marketo tracking code to centralize reader engagement data

Blaž Udovč avatar
Written by Blaž Udovč
Updated over a week ago

Notes:

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


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

  • Event name

  • Doc name

Read Doc 2 minutes

  • Event name

  • Doc name

Read Doc 3 minutes

  • Event name

  • Doc name

Read Doc 4 minutes

  • Event name

  • Doc name

Read Doc 5 minutes

  • Event name

  • Doc name

Read Doc 8 minutes

  • Event name

  • Doc name

Read Doc 10 minutes

  • Event name

  • Doc name

Personalization Form Fill

  • Event name

  • Doc name

Poll Submit

  • Event name

  • Doc name

  • Question

  • Response

View Chart

  • Event name

  • Doc name

  • Label

View Image

  • Event name

  • Doc name

  • Label

View Map

  • Event name

  • Doc name

  • Label

View PDF

  • Event name

  • Doc name

  • Label

Watch Video

  • Event name

  • Doc name

  • Label

Listen to Audio

  • Event name

  • Doc name

  • Label


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

Did this answer your question?