Skip to main content

Microsoft Dynamics tracking code and custom events

Using the Microsoft Dynamics tracking code to centralize contact engagement data and identify known contacts.

Enable Microsoft Dynamics tracking to send contact activity to Microsoft Dynamics when contacts interact with your Turtl content.

How to enable the tracking code

To enable the tracking code, please follow the steps below:

1. Copy your tracking script.

In Microsoft Dynamics, navigate to CI-J Settings > Web Tracking > Add Tracking Script (CI-J) and copy the tracking script provided.

2. Access the Integrations Hub

To access the Integrations Hub, click on "Integrate" on the left hand menu.

The Integrations screen will show all available integrations in a grid layout.

3. Configure and enable the tracking code

Click on Microsoft Dynamics.

Under the settings tab, navigate to the Configure Microsoft Dynamics Integration section and paste your tracking script into the Tracking code box and click save.


​Click on "Reader Intent Data" to expand the section.

Toggle on the setting to enable the tracking code across your Docs.

What information does the tracking code collect by default?

The Microsoft Dynamics tracking code collects the following engagement activities by default:

  • Website/page visits — A page-view event is recorded each time a tracked page loads.

  • Link clicks — An event is recorded each time a reader clicks a link on a tracked page. The full destination URL is captured.

How do the default events appear in Microsoft Dynamics?

You can verify that tracking is working by creating new content, viewing it, and then checking whether the page-view activities appear in Microsoft Dynamics.

To view the collected data:

  1. Navigate to Contacts.

  2. Open the relevant contact record.

  3. Select the Summary tab.

  4. Review the Timeline section.

Website/page visits and link clicks will appear as activity entries in the timeline, alongside the contact's other engagement history.

How to send custom contact engagement events to Microsoft Dynamics?

Within Integrations, click Microsoft Dynamics, then go to the Settings tab and open the Reader Intent Data section.

Under Custom events, you can now automatically enable custom events yourself by expanding each heading and toggling on the options you want.

Once selected, you’ll see the following confirmation:

You will then automatically see each selected custom event in your Microsoft Dynamics account.

Custom events list with properties

Below is a description of each of the custom events used:

Notes:

  • Properties in bold can be used for all events.

  • Other properties are event-specific.

  • Words between braces are data types/field types, eg. Page URL (string) → Page URL value is a string.

  • Please contact our Support Team to share your ideas if you want to track something else.

Event name

Custom properties

Chapter page turn

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Title page turn

Page turn

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Content page turn

Read time 30 seconds

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Read time 1 minute

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Read time 2 minutes

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Read time 3 minutes

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Read time 4 minutes

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Read time 5 minutes

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Read time 8 minutes

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Read time 10 minutes

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Enter chapter

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Enter Content page(s)

Leave chapter

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Leave Content page(s)

Logo click

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Contents menu click

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Download the PDF version

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

PDF download button in the Contents menu

Open fullscreen

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Link click

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Destination (string)

Lead capture form submission

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Personalization form submission

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

Poll submission

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Question (string)

  • Response (string)

Share button click - Email

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Share button location (string)

Share button location custom property specifies the location where the share button was clicked:

  • Toolbar

  • Immerse

  • Backcover

Share button click - X

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Share button location (string)

Share button location custom property specifies the location where the share button was clicked:

  • Toolbar

  • Immerse level widget

  • Back cover

Share button click - Facebook

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Share button location (string)

Share button location custom property specifies the location where the share button was clicked:

  • Toolbar

  • Immerse level widget

  • Back cover

Share button click - Linkedin

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Share button location (string)

Share button location custom property specifies the location where the share button was clicked:

  • Toolbar

  • Immerse level widget

  • Back cover

Share button click - Xing

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Share button location (string)

Share button location custom property specifies the location where the share button was clicked:

  • Toolbar

  • Immerse level widget

  • Back cover

View chart

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Source (string)

  • Open chart in zoom mode

View image

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Source (string)

  • Open image in zoom mode

View map

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Source (string)

  • Open the map in zoom mode

View PDF

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Source (string)

  • Open PDF in zoom mode

Watch video

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Source (string)

Listen to audio

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Source (string)

View Matterport tour

  • content_name (string)

  • content_url (string)

  • page_url (string)

  • chapter_title (string)

  • workspace (string)

  • Label (string)

  • Source (string)

How do these custom events appear in Microsoft Dynamics?

The custom events will show up in a timeline for both contacts and leads.

Did this answer your question?

Related Articles

Turtl Help Center