Skip to main content

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

What you can receive postbacks for

ConversionWhen it fires
InstallA new app install is attributed to your click.
SignupThe user completes registration, as defined by the advertiser.
In-app eventA 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

Tracking links

The parameters you append to your click tracking links.

Postbacks and macros

The macros Linkrunner fills into your postback URLs, with examples.
Need help? Contact support@linkrunner.io