> ## Documentation Index
> Fetch the complete documentation index at: https://docs.linkrunner.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracking Links

> Parameters you append to your Linkrunner click tracking links

## Overview

Linkrunner gives the advertiser a tracking link for each campaign. You point your traffic at that link and append the parameters below. These parameters tell Linkrunner who sent the click so it can attribute the install and return your identifiers on the postback.

A tracking link looks like this. The domain is the advertiser's own tracking domain, so always use the exact link Linkrunner provides. The example below uses `track.example.com` as a placeholder.

```
https://track.example.com/?c=CAMPAIGN_ID&tid=YOUR_CLICK_ID&s2=YOUR_CAMPAIGN_ID
```

`c` is the Linkrunner campaign identifier, set by the advertiser when they create the link. You add the rest.

<Warning>
  Your platform must replace its own click macros before the click reaches Linkrunner. If the final URL still contains a value like `{click_id}` or `{campaign_id}`, Linkrunner stores it as text. Linkrunner only fills macros in the server-to-server postback URL.
</Warning>

## Parameters

You fill each parameter with your own value at click time.

### Required

| Parameter | Description                                                                                                                                                           |
| --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `tid`     | A unique ID you generate for every click. Linkrunner returns this value in the `{click_id}` and `{tid}` postback macros, so you can match conversions back to clicks. |

### Passthrough values

| Parameter | Description                                                                                               |
| --------- | --------------------------------------------------------------------------------------------------------- |
| `s2`      | Optional campaign, source, or publisher value. Linkrunner returns this in the `{s2}` postback macro.      |
| `s3`      | Optional ad set, placement, or sub-publisher value. Linkrunner returns this in the `{s3}` postback macro. |
| `s4`      | Optional deduplication or extra tracking value. Linkrunner returns this in the `{s4}` postback macro.     |

### Device and request

Pass device advertising IDs when you have them. They improve match rates, especially for device-ID matching.

| Parameter   | Description                                                                           |
| ----------- | ------------------------------------------------------------------------------------- |
| `gaid`      | Google Advertising ID (Android).                                                      |
| `idfa`      | iOS Advertising ID (Apple).                                                           |
| `device_id` | Optional fallback. Linkrunner treats it as GAID or IDFA based on the device platform. |

<Note>
  URL-encode every value before appending it. Linkrunner stores values as received.
</Note>

## What not to put in the tracking link

Do not add postback-only values to the tracking link.

| Value                                      | Where it belongs                                                       |
| ------------------------------------------ | ---------------------------------------------------------------------- |
| `postbackKey` or another secret key        | Your postback URL template, not the user-facing tracking link.         |
| `{event_name}`                             | The postback URL template. There is no event name at click time.       |
| `{revenue}`, `{sale_amount}`, `{currency}` | The postback URL template. These values exist only after a conversion. |

## Example

A complete click tracking link:

```
https://track.example.com/?c=OgWmhiSXhG&tid=a1b2c3d4e5&s2=camp_88&s3=pub_4471&gaid=38400000-8cf0-11bd-b23e-10b96e40000d
```

## Troubleshooting

**Conversions arrive with an empty click ID.**
You did not send `tid` on the click, or the value was empty. Confirm the final clicked URL includes `tid=` with a unique value.

**The final URL still shows `{click_id}` or another macro.**
Your platform did not replace that macro before redirecting the user. Replace it in your platform first, then send the resolved value to Linkrunner.

**Installs are not attributed to your clicks.**
Check that traffic actually passes through the Linkrunner tracking link and that the campaign identifier (`c`) is correct. If you rely on device-ID matching, make sure `gaid` or `idfa` is present on the click.

**Need help?** Contact [support@linkrunner.io](mailto:support@linkrunner.io)