How to Integrate MAAS with S2S & Firebase
S2S integration is that which allows communication between two ad servers. More specifically communication between an ad network and a publisher. It is commonly used for purposes like mediation, auctions, etc. S2S integrations are used by mobile advertisers and ad networks. It is used to determine the number of installations that are driven by an ad that is served.
S2S integration consists of two parts; one is the Click Setup and another one is the Postback (Install or Event) Setup.
First, we will move to the Click Setup.
Step 1 - Get the tracking link from your advertiser or agency for which they would like to track the install or event on.
Sample click URL: https://apps.apple.com/ru/app/megafonapp-tv/id6359834314?referrer=app_tracking_id%3D385986435901094713%26ym_tracking_id%3D8238186804151215016
The above link is a sample URL which doesn’t include tracking parameters, our next step is to ask the client to ask for tracking parameters in tracking URL with postback macros. Step 2 - Ask the client to share the complete URL with tracking parameters. These parameters include necessary tracking placeholder and macros to pass the correct values between advertiser and ad network.
Example: The client has shared the below parameters with the above tracking URL -
Step 3 - Configure the click URL by combining step #1 and step #2
Preview of the Android URL: https://apps.android.com/ru/app/megafonapp-tv/com.asdf.6359834314?referrer=app_tracking_id%3D385986435901094713%26ym_tracking_id%3D8238186804151215016&click_id={click_id}&aaid={sub8}&sub3={offer_id}%7C{pid}%7C{sub6}%7C16&aff_sub={pid}_{sub1}
Preview of the iOS URL: https://apps.apple.com/ru/app/megafonapp-tv/id6359834314?referrer=app_tracking_id%3D385986435901094713%26ym_tracking_id%3D8238186804151215016&click_id=%7bclick_id%7d&idfa=%7bsub8%7d&sub3=%7boffer_id%7d%7C%7bpid%7d%7C%7bsub6%7d%7C16&aff_sub=%7bpid%7d_%7bsub1%7d
The terms 'click_id', 'aaid', 'sub3', and 'aff_sub' in the above URL are placeholders provided by the client. You can use the above sample to configure the click URL and use these URLs to set up on the MAAS Platform (Affise).
Step 4 - Configuring the postback URL
MAAS has a dedicated postback URL for all S2S integrations and has similar placeholders across the MMPs and networks.
There are two types of postback URLs for which we configure for MAAS in S2S; one is Global Install Postback URL and another Global Event Postback URL.
Below is the value table for MAAS placeholders and their names -
Mandatory Parameters | Name | MAAS (IfaaS) Placeholder | Sample Client Postback Macros |
| Click ID | r | {click_id} |
| Advertising ID | udid | {aaid}/{idfa} |
| offer_id or Custom Parameter | cf | {sub3} |
| Sub Publisher ID | spid | {sub1} |
| Install ID or Event ID | e | Hardcoded value (From Affise) |
| Event Name (For event campaigns) | en | Hardcoded value from the client |
| MAAS Advertiser ID (Affise) | a | From Affise |
Install postback URL:
Event postback URL:
We will use the above URL to create the postback URL. Once these postbacks URLs are configured, you can share this for configuring in their platform.
Step 5 - Configuring MAAS Postback URL
Use the above URLs and MAAS placeholder table to configure the postbacks.
Example - Let's say we have XYZ Client who wants to configure install and two events (purchase and sign-in).
