> ## 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.

# Affiliate Partner Integration

> Send Linkrunner your clicks and receive server-to-server postbacks on installs and in-app events

## Overview

Linkrunner is a Mobile Measurement Partner (MMP). When you run traffic to an advertiser who uses Linkrunner, the integration works in two directions:

1. **You send us clicks.** You point your traffic at a Linkrunner tracking link and append your own identifiers (most importantly your click ID). Linkrunner records the click and uses it to attribute installs.
2. **We send you postbacks.** When an install or a post-install event is attributed to your click, Linkrunner fires a server-to-server postback to your endpoint with the data filled into the macros you define.

This is the same model used across the industry, so if you have integrated with other MMPs the flow will feel familiar.

```
Your traffic
   │  click  (you append click_id + sub params)
   ▼
Linkrunner tracking link  ──►  install attributed to your click
   │
   │  postback (we fill your macros: click_id, event, revenue, ...)
   ▼
Your endpoint
```

## How attribution works

The link between a click and a conversion is your **click ID**. You generate a unique ID for every click and pass it to Linkrunner on the tracking link as `click_id`. When a conversion is attributed back to that click, Linkrunner returns the same value in the `{click_id}` macro on the postback. You match the postback to your original click using that value.

<Note>
  Pass a unique `click_id` on every click. Without it, Linkrunner cannot echo an identifier back to you on the postback, and you cannot reconcile conversions against your clicks.
</Note>

## What you can receive postbacks for

| Conversion       | When it fires                                                                                                                                         |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Install**      | A new app install is attributed to your click.                                                                                                        |
| **Signup**       | The user completes registration, as defined by the advertiser.                                                                                        |
| **In-app event** | A post-install event the advertiser tracks (for example a purchase or a custom event). Revenue and currency are included when the event carries them. |

The advertiser controls which of their events map to a postback to you and whether revenue is shared. You provide one postback URL template per conversion you want to receive.

## Next steps

<CardGroup cols={2}>
  <Card title="Tracking links" icon="link" href="/affiliate-partners/tracking-links">
    The parameters you append to your click tracking links.
  </Card>

  <Card title="Postbacks and macros" icon="satellite-dish" href="/affiliate-partners/postbacks">
    The macros Linkrunner fills into your postback URLs, with examples.
  </Card>
</CardGroup>

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