Urchin Tracking Module (UTM) parameters are text strings appended to your page URLs to help track traffic sources. SmartPush supports custom UTM tracking across email campaigns, SMS campaigns, automation flows, and popup forms, allowing merchants to analyze marketing performance more accurately.
This guide explains how UTM parameters work in SmartPush and how to configure them for different marketing scenarios.
UTM Overview
UTM parameters help identify the source, medium, and campaign of incoming traffic. The standard parameters are listed below:
| Parameter | Description | Default Value |
| utm_source | Identifies the traffic source (e.g., newsletter, Google Ads) | smartpush |
| utm_medium | Identifies the traffic channel (e.g., email, SMS) | email / sms (depending on node type) |
| utm_campaign | Tags a specific campaign | Email/SMS campaign ID, or automation: [[FlowID]]_[[NodeID]] |
| Note: SmartPush automatically appends these parameters to all links in emails, SMS messages, automation flows, and popup buttons. You can customize these values using the Advanced settings module. |
How to Set UTM Parameters
For Email Campaigns
For email campaigns, you can configure UTM parameters in the campaign's Advanced settings. To configure them:
- In the SmartPush app, go to Campaigns > Campaign List.
- Create a new email campaign, or select an existing campaign from the list.
On the settings page, scroll down to the Advanced settings section. By default, the system automatically applies the following values:
- utm_source: smartpush
- utm_medium: email
- utm_campaign: [[CampaignID]]
Enable Customize Data Tracking Parameters to edit the values as needed.
For A/B Testing Campaigns
For A/B testing campaigns, you can configure UTM parameters in the campaign's Advanced settings. To configure them:
- In the SmartPush app, go to Campaigns > Campaign List.
- Create a new A/B testing campaign, or select an existing campaign from the list.
After configuring the A/B test versions, go to the Advanced settings section. By default, the system automatically applies the following values:
- utm_source: smartpush
- utm_medium: email
- utm_campaign: [[CampaignID]]
Enable Customize Data Tracking Parameters to edit the values as needed.
For SMS Marketing
For SMS marketing campaigns, you can configure UTM parameters in the campaign settings. To configure them:
- In the SmartPush app, go to Campaigns > Campaign List.
- Create a new SMS campaign, or select an existing campaign from the list.
On the settings page, scroll down to the UTM Data Tracking section. By default, the system applies the following values:
- utm_source: smartpush
- utm_medium: sms
- utm_campaign: [[CampaignID]]
Enable Customize Data Tracking Parameters to edit the values as needed.
For Automation Flows
For Automation Flows, each node automatically appends UTM parameters. To customize them:
- In the SmartPush app, go to Automations > Marketing Automation.
- Create a new automation, or select an existing automation task from the list.
- In the workflow editor, click the Send an email or Send a text message node where you want to configure UTM parameters.
In the node settings panel, locate the UTM Data Tracking section. By default, the system applies the following values:
- utm_source: smartpush
- utm_medium: email / sms (depending on the node type)
- utm_campaign: automation:[[FlowID]]_[[NodeID]]
Enable Custom UTM parameters, then customize the values as needed.
For Popup Forms
For Popup Forms, UTM parameters can be added to links when UTM tracking is enabled. To configure them:
- Go to Pop-ups & Forms > Pop-up List.
- Create a new popup form, or select an existing one from the list.
- In the popup editor, go to the Form settings tab.
Locate the UTM Data Tracking section and enable the toggle. Once enabled, the system automatically appends the following parameters to the links triggered by the popup:
- utm_source: smartpush
- utm_medium: popup
- utm_campaign: [Popup ID]
Default UTM Parameters
If UTM customization is not enabled, SmartPush automatically applies the following default values:
| Scenario | utm_source | utm_medium | utm_campaign |
| Email Campaign | smartpush | Email Campaign ID | |
| SMS Campaign | smartpush | sms | SMS Campaign ID |
| Automation Flow | smartpush | email / sms | automation:[[FlowID]]_[[NodeID]] |
| Popup Forms | smartpush | popup | Popup ID |
Advanced Settings & Custom UTM Tracking
UTM tracking is enabled by default. SmartPush provides advanced UTM settings that allow you to customize UTM tracking parameters.
- Custom UTM Parameters: This custom option is disabled by default. Users can enable it to override the default values.
- Collapsed View: When the custom option is not selected, the UTM fields remain hidden.
- Expanded View: When this option is selected, all UTM configuration fields are displayed and can be customized.
- Tooltip / FAQ: Hover over the question mark icon (?) to view the following explanation:
UTM parameters are appended to your page URLs to track traffic sources. If custom UTM tracking is disabled, SmartPush will apply default values automatically. Modify these settings with caution.
Configurable UTM Fields
The following UTM fields can be customized:
- utm_source
- utm_medium
- utm_campaign
When creating a new node or when the node has not been edited, the following default values are automatically populated:
- Utm_source: smartpush
- utm_medium
- email (email node)
- sms (SMS node)
- Utm_campaign
- Campaigns: [[CampaignID]]
- Automation flows: [[FlowID]]_[[NodeID]]
Variable Logic (Automation Only)
- Only utm_campaign supports variables: [[FlowID]] and [[NodeID]].
- Variables can be manually entered using the correct format. Invalid variables will be treated as plain text.
- Deleting a variable removes it entirely as a block.
Input Validation
UTM fields are validated for:
- maximum length
- invalid characters
Copying & A/B Testing
- When copying an automation task or campaign with custom UTM tracking enabled, the UTM configuration will be copied automatically.
- Popup forms that use A/B testing and contain buttons linking to pages (such as Add to Cart) also support UTM tracking.
Viewing UTM Data
To view UTM tracking data, go to Data Analysis in the SmartPush dashboard.
In the Automation or Campaign data view, the UTM Data Tracking column displays the latest UTM parameters for each node or campaign.
For child nodes, click the expand icon (+) next to the parent node to view the UTM data for each sub-node.
Best Practices
To ensure accurate tracking results, follow these recommendations:
- Modify UTM parameters only if you understand your tracking requirements.
- Use consistent campaign naming conventions for clearer analytics.
- Always test your links after configuring UTM parameters to confirm that tracking works correctly.