MixdeskHelp Center
Skip to content

Developer Documentation

Track Campaigns with UTM Parameters

Last updated Sep 2, 2025

On this page

What are UTM parameters?

UTM parameters identify a link’s source, medium, keyword, content, and campaign. Add them to URLs used in advertising or other referrals so Mixdesk can record landing-page attribution.

UTM tracking is typically used with the Website channel. Add parameters to advertising links; when a visitor follows the link and starts a conversation, the attribution data is passed to Mixdesk for analysis.

UTM fields

  • utm_source
    Identifies the advertiser, website, publication, or other source that brings traffic.
    Exampleutm_source=google
  • utm_medium
    The advertising or marketing medium, such as cost per click, banner advertising, or an email newsletter.
    Exampleutm_medium=cpc
  • utm_term
    Identifies a paid-search keyword. Use utm_term when manually tagging paid-keyword campaigns.
    Exampleutm_term=mixdesk
  • utm_content
    Distinguishes similar content or links within the same advertisement. For example, give two links with the same destination different utm_content values to compare placements.
    Exampleutm_content=logolink or utm_content=textlink
  • utm_campaign
    Identifies a promotion or campaign, such as its name, slogan, or promotional code.
    Exampleutm_campaign=11gouwujie

Use UTM parameters

Append the UTM parameters to the destination URL. For example, the destination is http://www.sample.com/ and you advertise on Google for the keyword keyword. The placement is among the first three search results, the pricing model is cost per click, and the internal campaign is summer_promotion. The final tagged URL is:

http://www.sample.com/?utm_source=google&utm_term=keyword&utm_content=top3&
utm_medium=cpc&utm_campaign=summer_promotion

When a visitor opens a tagged URL and starts a conversation, team members can see the UTM details in the sidebar. After the conversation ends, its UTM information is also searchable in Conversation History.

Tips

  • UTM parameters can appear in any order.
  • Mixdesk does not require a particular parameter, but including at least utm_source is recommended.
  • Parameter values can contain Chinese. Some advertising platforms require the URL to be URL-encoded.
  • Use Google’s Campaign URL Builder to generate a tagged URL.

Related articles

Still need help?

Contact support@mixdesk.com for help with your setup.