Link placeholders
A link's destination URL is the brand's address the visitor is sent to. It can contain placeholders, which Routy fills in on every click, so the brand receives values that are only known at that moment: the click's own ID, or a value that arrived on your link.
Routy's placeholders
Put either one where the brand expects its click ID, for example:
https://brand.example/landing?clickid=[%ClickId%]
The dynamic parameter is shorter and easier to read than the click ID, which is why many brands are given it instead. For a traffic source of type Media it is a random 18-character code rather than a counter.
You often don't need to add them
When Routy already knows which parameter an affiliate program reads the click ID from, it adds the click ID or dynamic parameter to the destination URL itself. That only happens when your destination URL contains neither placeholder. Write one yourself and Routy uses yours as it stands.
Only these two
[%ClickId%] and [%Dynamic%] are the only placeholders written as [%ā¦%]. Anything else in
that form, such as [%Tracker%] or [%Campaign%], is never filled in. A click whose destination
URL still contains [% or %] is blocked: the visitor sees an error page instead of the brand,
and you get a Clicks blocked: invalid destination URL
issue.
Passing on a value from your link
To send the brand a value that arrived on your link, name the parameter in the destination URL. A
click on ā¦/click/12345?utm_source=newsletter fills each of these with newsletter:
Names are matched without regard to capitals.
Use {{name}} unless you have a reason not to. An unencoded value that contains &, # or a
space breaks the address: [kw] with the value shoes & bags gives the brand shoes and a stray
parameter.
When the parameter isn't on the click
If the visitor's click doesn't carry the parameter, the placeholder is left in the address as you
wrote it: the brand receives ?source={{utm_source}} literally. Make sure every link that uses the
destination URL is shared with that parameter, or ask the brand to ignore the literal text.
What doesn't need a placeholder
Your own parameters are not passed on unless the destination URL names them, except to a destination on a Routy domain. See What reaches the brand.
Common problems
Clicks are blocked with "Invalid destination URL".
The destination URL contains a [%ā¦%] placeholder other than [%ClickId%] or [%Dynamic%], often a
misspelling or one copied from an old guide. Fix it on the link and the next click goes through.
The brand's partner URL has square brackets around its own macro, such as [%7Bclickid%7D].
Routy can mistake that for one of its own placeholders and block the click. Contact support with the
link.
The brand receives {{something}} literally.
The click didn't carry something. See When the parameter isn't on the click.
The brand's reports show the click ID with hyphens and ours without, or the other way round.
They are the same ID. Routy fills [%ClickId%] without hyphens.
When to escalate to engineering
- A destination URL contains only
[%ClickId%]or[%Dynamic%]and its clicks are still blocked. - The brand receives an empty value where the click clearly carried the parameter.