Tracking the campaign is mandatory to run your CPI (cost per install) campaigns; so Tracking URL must be set properly before initiating your campaigns. 

App Samurai is integrated with major attribution and tracking providers. If you don’t find your partner on the list or use custom tracking solution, don’t worry! We have S2S tracking mechanism in order to handle such integrations.

Integration will consist of 3 steps:

1.    Setting up Tracking URL/Measurement URL

2.    Setting up Install Postbacks

3.    Setting up Event Postbacks (not mandatory)
​

You need to include App Samurai’s macros in your tracking URL to measure certain parameters. Our macros are as follows:
​

{ref_id}: Unique App Samurai click ID 

{sub_id}: Sub-publisher ID

{ios_ifa} or {device_id}: iOS IFA (IDFA)

{google_aid} or {device_id}: Google Advertising ID (GAID)

{app_name}: App Name

You can use any macro depending on your needs, but please keep in mind that {ref_id} is mandatory to include in your tracking link.

iOS : https://URL.com/clicks?ref={ref_id}&ifa={device_id}&pub={sub_id}

Android: https://URL.com/clicks?ref={ref_id}&google_id={device_id}&pub={sub_id}

Required Parameters

ref_id: Unique click ID for App Samurai
​

Advanced Parameters

*If you are going to use a Global Postback, please feel free to use the second one (Sample Android install postback). It includes every parameter required for iOS campaigns. 

Sample iOS install postback:

https://postback.appsamurai.com/api/callbacks/postback?ref_id={YOUR CLICK ID MACRO}&device_id={YOUR iOS IFA MACRO}&conversion_timestamp={YOUR CONVERSION TIME MACRO}&country_code={YOUR CONVERSION COUNTRY MACRO}&region={YOUR REGION MACRO}&carrier={YOUR CARRIER MACRO}&ip={YOUR IP MACRO}&language={YOUR LANGUAGE MACRO}&app_version={YOUR APP VERSION MACRO}&attribution_type={YOUR ATTRIBUTION TYPE MACRO}&user_agent={YOUR USER AGENT MACRO}

Sample Android install postback:

https://postback.appsamurai.com/api/callbacks/postback?ref_id={YOUR CLICK ID MACRO}&device_id={YOUR GOOGLE AD ID MACRO}&android_id={YOUR ANDROID ID MACRO}&conversion_timestamp={YOUR CONVERSION TIME MACRO}&country_code={YOUR CONVERSION COUNTRY MACRO}&region={YOUR REGION MACRO}&carrier={YOUR CARRIER MACRO}&ip={YOUR IP MACRO}&language={YOUR LANGUAGE MACRO}&app_version={YOUR APP VERSION MACRO}&attribution_type={YOUR ATTRIBUTION TYPE MACRO}&user_agent={YOUR USER AGENT MACRO}

You can also set up event postback, in addition to install postback with the following parameters:   

ref_id: Unique click ID for App Samurai

*If you are going to use a Global Postback, please feel free to use the second one (Sample Android event postback). It includes every parameter required for iOS campaigns. 

Sample iOS event postback:

https://postback.appsamurai.com/api/callbacks/in_app_event_postback?ref_id={YOUR CLICK ID MACRO}&device_id={YOUR iOS IFA MACRO}&event_name={YOUR EVENT NAME MACRO}&event_timestamp={YOUR EVENT TIME MACRO}&ip={YOUR IP MACRO}&user_agent={YOUR USER AGENT MACRO}
​

Sample Android event postback:

https://postback.appsamurai.com/api/callbacks/in_app_event_postback?ref_id={YOUR CLICK ID MACRO}&device_id={YOUR GOOGLE AD ID MACRO}&android_id={YOUR GOOGLE AD ID MACRO}&event_name={YOUR EVENT NAME MACRO}&event_timestamp={YOUR EVENT TIME MACRO}&ip={YOUR IP MACRO}&user_agent={YOUR USER AGENT MACRO}

Please keep in mind that ref_id here is also mandatory. You will replace {YourClickIDMacro} with your own system’s macro assigned for unique click ID received with tracking URL.

If you need technical question about S2S integration, please reach out us via success@appsamurai.com