UTM parameters are special code strings that can be appended to your links in order to track their clicks via Google Analytics. As default, each link within the template is UTM-free.

Example: http://yourlink.com

When UTM is enabled, each link within the template(s) will be modified for tracking purposes.

Example: http://yourlink.com?utm_source=ElasticEmail&utm_medium=emails&utm_campaign=campaign01&utm_content=specLink

In order to manage the UTM codes:

  1. Go to the campaign screen and click "Create campaign".
  2. Select a template.
  3. In "settings and tracking" section click "enable different UTMs for templates". This will open additional fields for UTM management.
  4. If you're running an A/X split test campaign and select more templates, each template will gain a separate UTM management tab.

There are 4 parameters available (all are case sensitive!):

UTM_Source - tracks where the traffic is coming from, eg. website, social channel.

UTM_Medium - used to identify the medium used to distribute the link, eg. emails

UTM_Campaign - used to track the "overall" campaign the traffic was generated by.

UTM_Content - used to track "specific" versions of the same campaign, eg. in A/X Split Test campaigns.

UTMs in API

It is possible to add UTM templates into the emails you are sending via the email/send API Call. The following parameters are available:

utmCampaign for utm_campaign tag

utmContent for utm_content tag

utmMedium for utm_source tag

utmSource for utm_source tag

a part of an email/send API Call that includes UTM parameters would look like this:

utmSource=tag1&utmMedium=tag2&utmCampaign=tag3&utmContent=tag4

Troubleshooting:

Notice how these parameters correlate to what can be seen in the Campaign Settings screen. If a customer presents us with just such API Call or its fragment containing the UTM parameters like above, advise them to split it up into separate values and input it into the Campaign UTM Settings.


Did this answer your question?