Documentation

S2S integration for publishers

How to build the Mapendo tracking and impression links, and the postbacks you can receive for installs and post-install events.

Tracking link

The base address of a Mapendo tracking link is:

GEThttps://trk.apperol.com/track/

Add these parameters:

ParameterDescriptionExample
campaign The Mapendo campaign ID. 12345 Required
placement The placement where the click is generated (your sub id). We use it to optimize. iFunny_entertainment_2 Optional
guid Your click id. Required to receive install postbacks from Mapendo. 323f17d960-66355d133fcbee9700d65349 Optional
idfa Apple advertising identifier (iOS only). 4AE9F11A-0E2C-465D-889E-6B1B11527C98 Optional
gaid Google advertising ID (Android only). ab39acb5-b6d3-463d-b098-5459d13fc88e Optional
sub_1 Custom variable 1. If you have sub publishers you can pass their IDs here. 21342 Optional
sub_2 Custom variable 2. banner_1 Optional
sub_3 Custom variable 3. display Optional
sub_4 Custom variable 4. custom Optional
sub_5 Custom variable 5. channel Optional
sub_6 Custom variable 6. 3G Optional
creative Name or id of the creative that generated the click. 320x50_fruit Optional

Example

A complete tracking link, with your values in place of the braces:

https://trk.apperol.com/track/?campaign=12345&placement={your_sub_id}&guid={your_click_id}&idfa={idfa}&gaid={gaid}&sub_1={your_custom_var_1}&sub_2={your_custom_var_2}&sub_3={your_custom_var_3}&sub_4={your_custom_var_4}&sub_5={your_custom_var_5}&sub_6={your_custom_var_6}&creative={creative_id}

And a real request:

https://trk.apperol.com/track/?campaign=12345&placement=iFunny_entertainment_2&guid=323f17d960-66355d133fcbee9700d65349&idfa=4AE9F11A-0E2C-465D-889E-6B1B11527C98&gaid=ab39acb5-b6d3-463d-b098-5459d13fc88e&sub_1=21342&sub_2=banner_1&sub_3=display&sub_4=custom&sub_5=channel&sub_6=3G&creative=320x50_fruit

Impression link

The base address of a Mapendo impression link is:

GEThttps://trk.apperol.com/impression/

Add these parameters:

ParameterDescriptionExample
campaign The Mapendo campaign ID. 12345 Required
placement The placement where the impression is generated (your sub id). iFunny_entertainment_2 Required
impressionid Your impression id. 323f17d960-66355d133fcbee9700d65349 Required
idfa Apple advertising identifier (iOS only). 4AE9F11A-0E2C-465D-889E-6B1B11527C98 Optional
gaid Google advertising ID (Android only). ab39acb5-b6d3-463d-b098-5459d13fc88e Optional
sub_1 App name. iFunny Optional
sub_2 Bundle id. id429610587 Optional
creative Name or id of the creative that generated the impression. 320x50_fruit Optional

Example

https://trk.apperol.com/impression/?campaign=12345&placement={your_sub_id}&impressionid={your_impression_id}&idfa={idfa}&gaid={gaid}&sub_1={app_name}&sub_2={bundle_id}&creative={creative_id}

And a real request:

https://trk.apperol.com/impression/?campaign=12345&placement=iFunny_1524874_224&impressionid=323f17d960-66355d133fcbee9700d65544&idfa=4AE9F11A-0E2C-465D-889E-6B1B11527C98&gaid=ab39acb5-b6d3-463d-b098-5459d13fc88e&sub_1=iFunny&sub_2=id429610587&creative=320x50_fruit

Install postback

To receive our install postbacks, set up your postback URL with the macros below and send it to your account manager (or to ops@mapendo.me). We replace each macro with its value for every install. Remember to pass your click id in the guid parameter of the tracking link.

MacroDescriptionExample
{guid} Your click id, as you passed it in the tracking link (parameter guid). 323f17d960-66355d133fcbee9700d65349 Required
{payout} Payout paid by Mapendo to the publisher for the conversion, in USD. 0.75 Optional
{source} Placement where the click was generated: the sub id of the publisher. Useful to optimize. iFunny_entertainment_2 Optional
{campaign_id} Mapendo campaign ID. 12345 Optional
{sub_1} Custom variable 1, as passed in the tracking link. 21342 Optional
{sub_2} Custom variable 2, as passed in the tracking link. banner_1 Optional
{sub_3} Custom variable 3, as passed in the tracking link. display Optional
{sub_4} Custom variable 4, as passed in the tracking link. custom Optional
{sub_5} Custom variable 5, as passed in the tracking link. channel Optional
{sub_6} Custom variable 6, as passed in the tracking link. 3G 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
{country} Two-letter country code of the user. US 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

Example

https://your_postback_url.com/install.php?clickid={guid}&cid={campaign_id}&rate={payout}&placement={source}&sub_id_1={sub_1}&sub_id_2={sub_2}&sub_id_3={sub_3}&sub_id_4={sub_4}&sub_id_5={sub_5}&sub_id_6={sub_6}&banner_id={creative}&country={country}&ip_device={ip}&idfa={idfa}&gaid={gaid}

Event postback

You can also receive the post-install events of the users you sent us (registrations, purchases…), on a second postback URL with these macros:

MacroDescriptionExample
{guid} Your click id, as you passed it in the tracking link (parameter guid). 323f17d960-66355d133fcbee9700d65349 Required
{action} Name of the post-install event. registration Optional
{value} Value of the event (1 when the advertiser does not send one). 1 Optional

Example

https://your_postback_url.com/event.php?clickid={guid}&event={action}&value={value}