Using Link Parameters to insert UTM codes

Save time and collect more data using Link Parameters in Dyspatch to automatically add campaign (UTM) parameters for Google Analytics.

UTM parameters can be set globally and per workspace, per template, or directly in the URL string in the email builder. See specificity rules here.

To set global and workspace utm parameters you must have Admin access

Adding UTM Parameters to an Email

Anyone that can build an email can add and remove Link Parameters. To get started, navigate to the Metadata tab then Link Parameters to start adding UTM codes.

Email Level UTMs

When the email is next exported, every link will now include the specified UTM codes.

Having trouble adding UTM codes for one off links? Try using Google's URL builder!

Global and Workspace Link Parameters are set up in Admin > Data > Link Parameters. Note that you must be an Admin to configure them.

To edit Global Link Parameters, click the three-dot menu (⋮) in the Global entry and select "Edit".

Email Level UTMs

To set up Workspace level Parameters, click "Create Parameter", select the workspace(s), and add the parameters. These will be applied to every email in a workspace.

Using Custom Parameters

In addition to UTM codes, you can use custom link parameters to pass other values in your links.

Custom Parameters can be set per template from the bottom of the Link Parameters tab (Metadata > Link Parameters) in the Email Builder, and/or added globally or per workspace from Admin > Data > Link Parameters.

Custom Parameters input and edit section of Metadata Link Parameters tab

Preview final link values with all parameters applied by hovering over a link in the Email Builder preview, or right-clicking and copying the link address.

FAQ

What order are these applied?

The UTM codes "closest" to the actual link take precedence. Meaning that any UTM codes on a link take precedence over any being applied to the whole email. Workspace Link Parameters take precedence over Global parameters.

You betcha! Make sure they're proper DML syntax, like @{variable}, to ensure they will be formatted correctly when exported.

How do I disable Global UTMs?

Remove any content from the UTM fields in the Global Link Parameters settings. Setting them to empty will prevent Global Link Parameters from being used and only Workspace and Template level link parameters are applied.

Add the data-no-utm attribute to an anchor tag to prevent Dyspatch from adding UTM codes. For example:

<dys-text>
  <a href="@{unsubscribe_url}" data-no-utm>Unsubscribe</a>
</dys-text>

The tracking alias field includes an alias='your-input-value' attribute to the link element. This is different than a traditional UTM parameter in that it is only used by Salesforce Marketing Cloud for click tracking. Other ESPs will ignore this attribute.

Related Articles

Part 4: ThemesDML 101Understanding Email GuardrailsEmailsUsing Email MonitoringEmailsSetting Up SSOIntegrations

Can't find what you're looking for?

Ask our support team, we're here to help!