1. Home
  2. Cookbook
  3. Campaigns
  4. How UTM parameters work in Exponea
  1. Home
  2. User guides
  3. Campaigns
  4. How UTM parameters work in Exponea
  1. Home
  2. User guides
  3. Analyses
  4. How UTM parameters work in Exponea

How UTM parameters work in Exponea

There are many UTM parameters used on the Internet, however only specific set is handled by Exponea.

Parsing UTM into session_start

When visitor comes to website with UTM parameters present in the URL, Exponea JS SDK automatically parses following into session_start event properties:

  • utm_campaign
  • utm_source
  • utm_medium
  • utm_content
  • utm_term

Additionally these URL parameters are parsed:

  • campaign_id
  • gclid

Other URL parameters are not parsed, however you can add more event properties into session_start (maybe other UTM parameters) by following a guide Extending session_start and global properties.



Automatic UTM in scenarios

When sending emails from Exponea scenario, following UTM parameters are added to hyperlinks in emails automatically:

  • utm_campaign (value from email action node name)
  • utm_medium (always “email”)
  • utm_source (“exponea” by default)


For example if you send an email with Email action node named “2016-10-27-newsletter” with a link to https://exponea.com/, final link will look like this:


Changing default utm_source

You can set utm_source in Project settings > Emails > UTM Source


Overriding automatic UTM parameters

As you see Exponea adds UTM parameters automatically (utm_campaign, utm_source, utm_medium). If you want to override let’s say utm_medium, you can do that by changing the link.

For example https://exponea.com/?utm_medium=crm will create this final link:


Adding other UTM parameters

If you want to add other utm parameters, which are not added by Exponea by default, you can do so by appending link in your email template. For example to add utm_id you can do:


Updated on November 6, 2017

Was this article helpful?

Related Articles