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:
https://trk.apperol.com/track/Add these parameters:
| Parameter | Description | Example | |
|---|---|---|---|
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_fruitImpression link
The base address of a Mapendo impression link is:
https://trk.apperol.com/impression/Add these parameters:
| Parameter | Description | Example | |
|---|---|---|---|
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_fruitInstall 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.
| Macro | Description | Example | |
|---|---|---|---|
{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:
| Macro | Description | Example | |
|---|---|---|---|
{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}