Routy

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

Placeholder Filled with Example
[%ClickId%] Routy's ID for this click: 32 letters and digits, no hyphens 0196d3f2a8c47b1e9f3a5d6c7e8b9a01
[%Dynamic%] The click's dynamic parameter: a short code that counts up per traffic source, after that source's prefix RT48213

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.

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:

Written as Value is encoded for a URL Use it when
{{utm_source}} Yes Almost always. This is the safe default
%utm_source% Yes You already use this form
[utm_source] No, it is inserted exactly as it arrived The value is already encoded and must not be encoded twice

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.