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.

2016-10-27_12h08_52

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)

2016-10-27_12h10_00

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:

https://exponea.com/?utm_campaign=2016-10-27-newsletter&utm_source=exponea&utm_medium=email

Changing default utm_source

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

2016-10-27_11h50_14

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:

https://exponea.com/?utm_medium=crm&utm_campaign=2016-10-27-newsletter&utm_source=exponea

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:

https://exponea.com/?utm_id=442178