S2S install tracking for advertisers
Mapendo receives your installs with a server-to-server postback (S2S), from your app, your network or your agency.
Your tracking link
Build your tracking link with our macros and send it to your account manager (or to ops@mapendo.me). We replace each macro with its value on every click.
Our offers reach most publishers through APIs, so device identifiers such as IDFA and GAID are not always available. To help you optimize and reach your KPIs, we can always send you the source of the click.
| Macro | Description | Example | |
|---|---|---|---|
{clickid} |
Our click id. Send it back to us in the postback (parameter guid). |
323f17d96066355d133fcbee9700d653491af9b9 |
Required |
{source} |
Placement where the click was generated: the sub id of the publisher. Useful to optimize. | iFunny_entertainment_2 |
Optional |
{gaid} |
Google advertising ID (Android only), when available. | ab39acb5-b6d3-463d-b098-5459d13fc88e |
Optional |
{idfa} |
Apple advertising identifier (iOS only), when available. | 4AE9F11A-0E2C-465D-889E-6B1B11527C98 |
Optional |
{idfv} |
Apple identifier for vendor (iOS only), when available. | 9C1A3B2E-7F55-4C1D-8E2A-1B3C4D5E6F70 |
Optional |
{creative} |
Name or id of the creative that generated the click. | 320x50_fruit |
Optional |
{ip} |
IP address of the device. | 192.168.0.1 |
Optional |
{ua} |
User agent of the device. | Mozilla/5.0 (iPhone; CPU iPhone OS 18_1 like Mac OS X)… |
Optional |
{lang} |
Language of the device. | en |
Optional |
Example
A complete tracking link with our macros:
https://your_tracking_link.com/click.php?pid=34t95&country=US&t_click_id={clickid}&subid={source}&apple_id={idfa}&google_id={gaid}&banner_id={creative}Install postback
For each install, call this address in real time (not in bulk):
GET
https://trk.apperol.com/install/We only need our click id back:
| Parameter | Description | Example | |
|---|---|---|---|
guid |
The click id that we passed in your tracking link (macro {clickid}). |
323f17d96066355d133fcbee9700d653491af9b9 |
Required |
payout |
The amount of the conversion, in USD. | 0.85 |
Optional |
Example
The postback template:
https://trk.apperol.com/install/?guid={click_id}&payout={payout}And a real request:
https://trk.apperol.com/install/?guid=323f17d96066355d133fcbee9700d653491af9b9&payout=0.85Response
We always answer with HTTP 200 and the text OK.