Documentation

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.

MacroDescriptionExample
{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):

GEThttps://trk.apperol.com/install/

We only need our click id back:

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

Response

We always answer with HTTP 200 and the text OK.