Support

Tracking Custom Events in GoSquared Contacts

What is Event Tracking?

Event tracking allows you to track important actions on your site, such as when a user updates their payment plan, or uses a particular product feature.

We encourage you to send data on all your key feature activations into GoSquared as custom Events, in order to understand how your users engage with these features over time.

Tracked events can be used as the basis of filtering and creating Smart Group segments in GoSquared Contacts, from the Events filter drop-down:

You can also access a top-line view of the number of Events triggered over a given time-period in the Events widget of your Trends dashboard.

What events can I track?

You can track an event for any action that happens on your site, or on your back-end system. You can name them anything you like, but it’s best to use a clear, concise name.

What can I do with event tracking data?

Example use-cases for custom Event tracking in GoSquared Contacts include:

☑️ Compare number of sign_in activations between two months.
☑️ Track how many subscribers purchased a ticket to an upcoming Webinar.
☑️ Monitor whether new users are successfully activating your platform’s key feature during their onboarding phase.
☑️ Compare the number of seats reserved for an in-person Event this year, compared to last year.

What Smart Group filters can I deploy on custom Events?

GoSquared Contacts allows you to filter for both custom Event count and custom Event time-range.

For example, you could detail the number of times your users have downloaded a white-paper, by using the count filters as per below:

Alternatively, you could compare how many users downloaded the white-paper this quarter, compared to the number of users who downloaded the quarter prior:

Example Code

The following examples show event tracking using the JavaScript Tracking Code. If you haven’t installed this yet, view our guide to installing GoSquared. For further examples including event tracking using server-side SDKs, see our Event API documentation.

Basic event tracking

Track a single event with a custom name:

_gs('event', 'Name of the event');

Event properties

You can include extra details with the event, which will be shown in the profile view of Customer Data Hub

gs('event', 'Event name', {
  extra: 'details',
  here: true
})

Example Video Tutorial


Server-side event tracking

You can also track events against profiles on the server side, using our Tracking API or any of our SDKs. Check out our Event API documentation for further details.