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:
-
Go to the campaign screen and click "Create campaign".
-
Select a template.
-
In "settings and tracking" section click "enable different UTMs for templates". This will open additional fields for UTM management.
-
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.
I can see incorrect or missing statistics in my campaign results
In order to resolve this, make sure you are passing UTMs only in one place. It's best to check if it's passed e.g. only in the campaign creator and not both in your campaign creator and a chosen email template's HTML code.
