Tracking URLs¶
Introduction¶
All creatives in your paid media campaigns will have a unique tracking URL associated with them, enabling full end-to-end tracking within our systems.
These URLs are built dynamically by our marketing suite to ensure the correct details are set on a per platform creative basis.
Creatives are defined in our system as a unique combination of assets (image, headline, body text) and landing page URL minus tracking.
Custom tracking parameters (UTMs)¶
If you need custom tracking made available to your landing page via query string parameters, such as ?utm_source=linkedin, this can be achieved using a combination of our available macros.
Macros¶
The following macros are available to build your custom tracking template:
| Macro | Description |
|---|---|
${CAMPAIGN_ID} |
Our internal numeric campaign identifier. |
${CAMPAIGN_NAME} |
TRANSFORMED. The custom name given to reference the campaign. |
${CLIENT_CAMPAIGN_NAME} |
TRANSFORMED. The custom name given by the client to reference the campaign. [1] |
${CAMPAIGN_TYPE} |
TRANSFORMED. The campaign type, such as "Retargeting" or "Lookalike". |
${CREATIVE_ID} |
Our internal numeric creative identifier. |
${CREATIVE_NAME} |
TRANSFORMED. The custom name given to reference the creative. |
${PLATFORM} |
Platform slug e.g. facebook or linkedin. |
${CHANNEL} |
One of: social, search, native, display. |
${GEO} |
A hyphenated combination of region, sub-region and country e.g. emea-cemea-de. |
${REGION} |
One of: apac, emea, nala. |
${SUB_REGION} |
OPTIONAL. TRANSFORMED. Free text sub region. |
${COUNTRY} |
OPTIONAL. Two character country code. |
TRANSFORMED: These fields will be transformed to lower case, whitespaces replaced with hyphens and url escaped for safety.
[1] Client campaign names should not contain other macros, such as platform name. UTMs can be built using macros in a structured way
Example¶
An example supplied landing page URL may look like:
https://www.example.com/landing-page?utm_source=${PLATFORM}&utm_medium=paid-${CHANNEL}&utm_campaign=${CAMPAIGN_NAME}--${GEO}
Which would render to, for example:
https://www.example.com/landing-page?utm_source=linkedin&utm_medium=paid-social&utm_campaign=learn-to-code-for-free--emea-cemea-de