UTM Measurement skill
The UTM Measurement skill is an organization skill from the Skills Directory in Mark (Optimizely Agent Platform). It standardizes your campaign tracking parameters and attribution conventions. Web traffic is then measured consistently across every channel, team, and tool.
The skill applies to everyone in your organization when you choose Organization during configuration. Creating an organization skill requires the Manage Skills permission.
Skill details
The following details apply to this skill:
- Shortcut – /utm-measurement
- Type – Organization skill
What the skill does
The skill does the following:
- Makes every tracked link, campaign name, ad name, and Urchin Tracking Module (UTM) value follow one taxonomy. A taxonomy is a fixed set of approved names and values. Traffic then reports cleanly and joins to leads, pipeline, and revenue.
- Builds paste-ready tracked URLs and designs or extends your naming convention.
- Audits links and platform exports before launch with an 11-check quality table and a launch verdict.
- Specifies UTM capture and consent handling, and explains why customer relationship management (CRM) leads do not match analytics sessions. Mark flags off-list values and never improvises them.
Before you begin
Confirm the following before you install the skill:
- You must have the Manage Skills permission to install this skill. If you do not, click Request in the Skills Directory to ask an administrator to install it.
- Mark works best with a connected analytics, tag management, ad platform, or CRM tool. Without one, paste exports. Checks that Mark cannot verify are marked "Not verifiable".
- Have your answers and files ready. Mark asks for them during configuration.
Information Mark asks for
Mark asks for the following during configuration. Skip optional items if you do not need them.
- Business, Tracked Sites, and Systems of Record – Your business, the domains that count as internal, and your system of record. The system of record anchors lead, pipeline, and revenue numbers.
- Campaign Naming Convention – The structure of your campaign names and the approved values for each field. If you do not have one, list your regions, products, and campaign types, and Mark proposes a structure for your approval.
- (Optional) Approved Taxonomy File – Often a spreadsheet, with approved content slugs.
- (Optional) Source, Medium, and Platform Exceptions – If you skip this, a default source and medium table applies.
- (Optional) How Tracking Is Captured Today – Including conversion events. If you skip this, Mark assumes only analytics session attribution.
Install the skill
Go to Directory > Skills, find UTM Measurement, and click Install. In the Setup required dialog, click Set up in chat. Mark asks who the skill is for, Myself (Personal) or Organization. Mark then asks whether to answer the remaining questions in chat or upload a document. For the full procedure, see Install a skill that needs configuration.
Use the skill
After configuration, enter /utm-measurement in Mark chat to run the skill on demand. Mark also applies it automatically when your request matches its When to use conditions. Try prompts like the following:
- Build tracked links for our paid social and email campaign launching next week.
- Audit this export of ad names and links before launch.
- Why do our CRM leads not match analytics sessions?
Things to know
Keep the following in mind:
- Your taxonomy is a snapshot. Mark flags any region, product, or event missing from the taxonomy as off-list until you edit the skill or update the file.
- A typo in an approved value becomes part of the taxonomy and spreads into every link built afterward.
Update the skill
When Optimizely publishes an updated version, Update displays on the skill's card in the Skills Directory. Mark keeps the information you provided during configuration and asks only for anything the updated version adds. To correct answers that are no longer accurate, edit the installed skill. See Update a skill and Manage skills.
Note
If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See Turn generative AI off across Optimizely applications.