The Metrikia tracking parameter template (mtk_*)
The mtk_* template per platform, where to paste it, what each parameter does and what compatibility mode means.
Metrikia recommends its own tracking parameter template on every ad platform. It always starts with mtk_source and ends with mtk_ad: this is what lets Metrikia recognise the platform, the channel and the exact ad of every click, whatever your UTM naming.
The template per platform
- Meta (Facebook, Instagram), URL parameters field of the ad or the account:
mtk_source=meta&mtk_campaign={{campaign.id}}&mtk_adset={{adset.id}}&mtk_ad={{ad.id}} - Google Ads, Final URL suffix field (account level):
mtk_source=google&mtk_campaign={campaignid}&mtk_adset={adgroupid}&mtk_ad={creative}&gclid={gclid} - TikTok Ads, URL parameters field (account level):
mtk_source=tiktok&mtk_campaign=__CAMPAIGN_ID__&mtk_adset=__AID__&mtk_ad=__CID__ - Pinterest Ads, URL parameters field (tracking):
mtk_source=pinterest&mtk_campaign={campaignid}&mtk_adset={adgroupid}&mtk_ad={adid} - OpenAI Ads (ChatGPT), tracking parameters of the campaign, ad group or ad:
mtk_source=openai&mtk_campaign={campaign_id}&mtk_ad={ad_id}
Each integration page gives you the exact template to copy: go to /app/integrations, open the integration, then the Tracking URL parameters section and click Copy.
What each parameter does
- mtk_source: the platform (meta, google, tiktok, pinterest, openai). A fixed value, not a macro: do not change it.
- mtk_campaign: the campaign identifier.
- mtk_adset: the ad set (ad group) identifier.
- mtk_ad: the ad identifier. This is what ties every click to the right creative.
Values in braces or underscores (for example {{ad.id}}, {creative}, __CID__) are platform macros: they are replaced by the real identifiers at click time.
Expected result
Within 24 hours, new clicks show up in /app/attribution with the exact campaign, ad set and ad. On the integration page, the Compatibility mode banner disappears.
Already using UTM parameters?
Keep them. Append the Metrikia template after an "&". Metrikia reads its own parameters (the ones starting with mtk_), the rest stays yours.
Compatibility mode
If your ads still send the ad identifier through the former template (utm_content) or through another tracker's parameter, Metrikia keeps finding the ad. You will then see a Compatibility mode banner on the integration page and a Metrikia tracking template item in data health: attribution works, but the source and channel depend on how your UTMs are named. Paste the Metrikia template to make it reliable.
Common problems
- "Tracking still does not work": the change only applies to new clicks. Older clicks keep their current attribution.
- "I still see the Compatibility mode banner": it is based on the clicks of the last 7 days. It disappears as soon as one click carries the Metrikia template.
- "The template shows up as is in my URLs (with the braces)": the platform did not expand its macros. Make sure the template is pasted in the tracking field named below, not in the destination URL.
Missing a feature? Suggest it in Ideas and Roadmap (in Settings). A technical issue? Use Report a bug from the help menu.
To go further, check out our blog, the documentation or contact support.