UTM Mapping

lars grønnegaard Updated by lars grønnegaard

Dreamdata provides a tool for mapping UTM parameters and referrer information into Channel, Source and Medium.

We have a large set of default mappings that ensure that for most cases this happens out of the box. If you have changes or additions to the mapping you can make them in Settings > UTM Mapping.

Rule Priority

For every session we find the rules that apply and then apply the rule with the lowest priority number. So if multiple rules apply only the one with the lowest priority number is applied. To ensure your mapping rules are applied you should restrict yourself to using numbers between 1 and 999.

Rule Input: Event, UTM Source, UTM Medium, Referrer.

Apart from the priority, each rule is made up of four input fields: Event, UTM Source, UTM Medium, Referrer. Event in this context means tracking event.

For each input you can use '%' as a wildcard. For instance '%' means match anything 'face%' means match anything that starts with 'face'. 'Facebook' means match exactly 'Facebook'. Matching is case sensitive.

If you don't want to match on anything in a field just enter '%'.

Rule Output: Channel, Source, Medium

The other end of the rule is the output made up of three fields: Channel, Source and Medium. Where Channel is used to describe the main lead channel, e.g. Paid or Organic and Source is used to describe the entity that sent the user e.g. Google. Medium is not currently used in the dashboards, but is available in the data platform.

You an either set the a value for the the field directly e.g. 'Paid', or you can pass the value of the utm_source or the utm_medium parameter by using '[source]' or '[medium]'.

Updating Data Models

When you modify the UTM mapping table it will impact your model the next time we build the data models, which typically happens within 6 hours.

How did we do?

Single sign-on