Routy

Tracking links and their parameters

Routy Links lists the links you send traffic through. Each one sends a visitor on to a brand's destination URL, records the click, and attributes it to you, your traffic source and whatever you added to the link. This page explains what a link address can carry, and which of those values reach the brand.

A link lives on your tracking domain:

Kind of link Address
A link from Routy Links https://<your tracking domain>/click/<link id>
An offer link (networks and partners) https://<your tracking domain>/click/offer/<offer id>
A cloaked link https://<your custom domain>/click/<name> — see Cloaked links
A short link https://<your short-link domain>/s/<code> — see Short links

Older links that use /route/ instead of /click/ still work. New links are issued with /click/.

The values that identify you and the traffic source are written into the link when Routy builds it. Leave them as they are: changing them by hand moves the click to someone else's traffic source, or stops the link working.

Append these to the address as query parameters, for example …/click/12345?PA=facebook&PB=summer-creative&cid={your-platform-click-id}.

Parameter What it records Where you see it
PA Sub ID A, your own label Parameter A on the click
PB Sub ID B, a second label Parameter B on the click
cid The click ID from your tracker or ad platform External Click ID on the click
camp An affiliate tracker, by id or by name Affiliate Tracker on the click. See Affiliate trackers

Keep PA, PB and cid to 100 characters or fewer.

Taking a value from another parameter

If your ad platform already puts a value on the address under its own name, point PA, PB or cid at that name in square brackets instead of copying it:

…/click/12345?PA=[utm_campaign]&utm_campaign=spring-sale

The click records spring-sale as Parameter A. This is useful when an ad platform's macro fills in utm_campaign and you can't edit what it produces. Values taken this way are cut to 50 characters.

What reaches the brand

This is the part that most often surprises people.

Parameters are not copied to the brand automatically. A visitor who clicks …/click/12345?utm_source=newsletter arrives at the brand's page without utm_source, unless the link's destination URL asks for it.

To send a value on, put a placeholder for it in the destination URL. A destination URL of

https://brand.example/landing?source={{utm_source}}

receives ?source=newsletter from that click. The placeholders and how they behave are on Link placeholders.

The exception: a destination on a Routy domain

When a link's destination is itself on Routy (one of our tracking domains, or one of your own custom tracking domains), every parameter on the click is copied to the destination, apart from the reserved ones below. That is what lets one Routy link hand a visitor on to another without losing your labels.

  • A value the destination URL already sets is kept. The incoming one does not replace it.
  • Reserved parameters are never copied.

Reserved parameters

These names belong to Routy. They are read by the link itself and never passed to a destination:

Affid, ts, trafficSourceId, camp, PA, PB, cid, clickId, subid, dyn, eid

Names are matched without regard to capitals, so pa and PA are the same parameter. If you need the brand to receive one of these values, use a placeholder in the destination URL, such as {{PA}}.

Common questions

I added ?utm_source=… to my link and the brand didn't receive it. That is expected. Add {{utm_source}} to the link's destination URL where the brand wants it. See What reaches the brand.

The brand received a value cut off at &. The [name] placeholder inserts the value exactly as it arrived. Use {{name}} instead, which encodes it safely. See Link placeholders.

A click shows no Parameter A even though my link had PA=[something]. The parameter in the brackets wasn't on the address when the visitor clicked, or was empty.

My clicks are blocked with "Invalid destination URL". The destination URL contains a placeholder Routy doesn't recognise. See Clicks blocked: invalid destination URL.

When to escalate to engineering

  • A value is on the click (you can see it in Events → Clicks) and the destination URL has a placeholder for it, but the brand still doesn't receive it.
  • A link on a Routy domain hands a reserved parameter on to its destination.