Add UTM Parameters to Campaigns

Overview

Urchin Tracking Module (UTM) parameters are tags or simple snippet codes added to the end of a URL. You can customise these parameters based on your requirements to accurately track user engagement from different traffic sources in your analytics software.

When your audience visits the URL appended with these parameters, your analytics software can track information, such as where clicks came from, what campaign directed the clicks to your website, how visitors came to your website, and whether visitors interacted with any content associated with a campaign.

Feature Support Matrix

The following table outlines where the UTM parameters are supported across different channels and features within MoEngage.

Channel / Module Supported 
Email
Push
SMS
WhatsApp
In-App
OSM
Inform
Flows
Connectors
RCS

You can set UTM parameters for each campaign individually. The changes you make in the UTM parameters at the campaign level override the general UTM parameters configured at the account level. These changes are applicable only to the specific campaign you are creating or editing and do not impact the general UTM parameters. For more information, refer to Configure General UTM Parameters at Account Level.

info

Information

  • MoEngage automatically inserts the general UTM parameters at the end of the links used in all the campaigns.
  • If you manually pass any UTM parameters as part of the URL for the current campaign, MoEngage skips the general UTM parameters.
  • Only the roles that are allowed to create campaigns and flows (Marketer, Manager, and Admin when CAF is OFF) can turn on or off the UTM parameters toggle.

Configure UTM Parameters for Campaigns

In the example below, we have outlined the steps to add UTM parameters to an Email campaign:

  1. Ensure that the general UTM parameters are turned on at Settings > App > UTM tracking.
    10 - general to email.png
  2. In the email template editor, go to the UTM parameters section.
    7 - email.png
  3. Click the accordion to expand the parameters.
    info

    Information

    If the UTM parameters are enabled in the general settings, the UTM parameters toggle for the current email campaign is turned on. By default, the UTM parameters configured in general settings are carried over to the campaign.

    8 - email 2.png
  4. Edit the value of UTM parameters. In all value fields, you can enter a static value or select a dynamic value. When you enter '@', a searchable drop-down list of values is displayed. The value field cannot be empty.
  5. Enable or disable individual parameters. You cannot disable the utm_source and utm_medium parameters.
    12 - email disabled.png
  6. Click + Create custom parameter to add a custom UTM parameter as a key-value pair.
  7. Click the delete icon for the custom parameter that is no longer required. You can delete custom UTM parameters that are carried over from the general settings.
    11 - email custom.png
  8. Turn off the UTM parameters toggle to disable the usage of UTM parameters in the current campaign. In that case, MoEngage does not insert UTM parameters in the links used in the current campaign.
    12 - disabled at email.png

Configure UTM Parameters for Campaigns in Flows

In addition to standalone campaigns, you can set specific UTM parameters for campaigns that are part of a MoEngage Flow. For a campaign created inside a Flow, the general UTM parameters configured for flows at the account level are populated by default. You can override these values and add more custom parameters to them.

In the example below, we have outlined the steps to add UTM parameters for Emails in Flows:

  1. Ensure that the general UTM parameters are turned on at Settings > App > UTM tracking. For example:
    10 - general to email.png
  2. In the canvas of the flow, click +.
  3. On the Add Stage page, select the ActionsMessaging > Email.
    Addstageflows.gif
  4. Hover over Email and click the Edit icon.
  5. In the email template editor, go to the UTM parameters section.
    14 - flow.png
  6. The process for editing these parameters now follows the same method as the one for a standalone campaign. You can:
    • Edit the value of any parameter.
    • Enable or disable individual parameters.
    • Add new custom parameters using + Create custom parameter.
    • Delete custom parameters.

For a detailed guide on each of these actions, refer to steps 4-7 in the Configure UTM Parameters for Campaigns section above.

info

Information

  • The links you add in the email will be wrapped up with UTM parameters. When the user clicks the links, they can see the UTM parameters with their values in the URL.
  • In the case of SMS and WhatsApp, you can add the UTM parameters only to the shortened links.
  • When shortened links are used in SMS and WhatsApp, the UTM parameters are visible once you click the link and land on the destination page.
  • Dynamic values will be fetched during runtime. If a dynamic parameter is not available for any campaign, the UTM parameter using that dynamic value is not appended to the link.
  • URLs fetched from the Content API are added to the link with UTM parameters at runtime.
  • If the click link tracking is disabled, MoEngage does not append the UTM parameters to the URLs.
  • If you use any space or special character while sending the UTM parameters as part of the link, URL encoding is supported.

Was this article helpful?
1 out of 1 found this helpful

How can we improve this article?