- records a
link_clickedevent in your project, and - sends the visitor on to the target with your UTMs added (HTTP 302).
Create a link
Click New link and enter:
The dialog shows a live preview of the URL that visitors land on.
How UTMs are added
- Each UTM you set is added to the target’s query string.
- A UTM that the target URL already has is kept as it is. Your link’s value does not replace it.
- A link with no
utm_contentgets its slug asutm_content. The Attribution page groups by this value as Short link. - A link with a Creator gets
refset to the creator’s referral code: the name in upper case, with spaces and other characters made into hyphens (Jane DoeisJANE-DOE). The Attribution page groups by it as Creator. A code that a player types in game (see Referral codes) credits the same creator. A target that already hasref,referralorreferral_codekeeps its own value. Arefputs the visit in the Referrals channel. - Other query parameters and the
#fragmentstay as they are. - Query parameters on the short link itself are not passed on. The redirect uses only the stored target.
Links to Steam
Steam’s UTM Analytics reads the same five UTM fields. It counts onlystore.steampowered.com/app/<id> and /sale/<name> pages, and only links with utm_source or utm_campaign. The editor warns you when a Steam target breaks one of these rules. Keep the number of different UTM values small: Steam hides combinations with little traffic. Use Test a UTM Link in Steamworks to confirm a new link.
Bulk create
Click Bulk create and paste up to 100 rows from a spreadsheet (tab separated) or a CSV. The columns are:url is required. A first row with column names lets you use another order. The result lists the new short link or the error for each row; a bad row does not stop the others.
Clicks, QR codes and archive
- The Clicks column counts
link_clickedevents in the selected date range. The filter menu and segments apply. Bots (link preview crawlers, for example) are labelleddevice: botand not counted. - QR code shows an SVG QR code of the short link. Download SVG saves it for print or video.
- CSV downloads all links with their short URL and clicks.
- Archive turns a link off: the short link shows a “Link not found” page (HTTP 404). Archived links keep their history and can be restored.
The link_clicked event
Each click is a server-side custom event (channel: server), so it shows in Activity and can be a funnel step.
Privacy: the redirect sets no cookie. The IP address is used only for the country lookup and the user agent only for device, OS and browser; neither is stored. Each click gets a new random anonymous ID, so a click is not joined to a later visit on your site. To follow visitors after the click, send them to your own site: the UTMs on the landing page are captured by the SDK as usual.
API
Viewers can read links; editors, admins and owners can change them. Every change is in the workspace audit log (link.created, link.updated, link.archived).
The redirect always works. Clicks count against the per-project ingest limit (
INGEST_PROJECT_EVENTS_PER_MINUTE) in their own bucket; over the limit, visitors are still redirected, but those clicks are not recorded. HEAD requests (link previews) are never recorded. Set SHORT_LINK_BASE_URL on the API (for example https://go.example.com/l) to show full short URLs; the address must route to the API’s /l/ path.