Table of Contents
Appsflyer
For Appsflyer Integration for normal clickId attribution would require the following:
● Attribution link template
● Postback URLs with Appsflyer supported macros
The complete attribution link after adding Swaarm macros:
https://app.appsflyer.com/com.testapp?pid=media_int&c={offer.name}&af_c_id={offerId}&af_siteid={publisher.id}&af_sub_siteid={publisher.subId}&clickid={id}&af_enc_data={offer.weGet}&idfa={device.ids.idfa}&advertiser_id={device.ids.gaid}&af_ua={user.encoded_ua}&af_ip={user.ip}&af_lang={user.language}&af_adset={pea.chain}
Install postback for iOS & Android:
https://track.yournetwork.swaarm-clients.com/postback?click_id={Click ID}&sale_amount={Event revenue USD}&gaid={Advertising ID}&idfa={IDFA}&country={Country code}&publisher_sub_id={Sub site ID}&rejection_reason={Blocked reason}&rejected_reason_value={Blocked reason value}
In-App event postback for both OS:
https://track.yournetwork.swaarm-clients.com/postback?click_id={Click ID}&event_id={Event name}&sale_amount={Event revenue USD}&event_value={Event revenue}&gaid={Advertising ID}&idfa={IDFA}&country={Country code}&publisher_sub_id={Sub site ID}&rejection_reason={Blocked reason}&rejected_reason_value={Blocked reason value}
Explanation:
yournetwork: Own Postback domain/subdomain needs to be adjusted
pid=media_int: Own Partner ID for Appsflyer needs to be adjusted
Documentation link: Appsflyer Integration with Swaarm
Appsflyer Advanced Privacy Postbacks
Appsflyer - Advanced Privacy Integration:
Privacy Postback URLs with Appsflyer supported macros:
Install postback for Android / IOS:
https://track.yournetwork.swaarm-clients.com/postback?publisher_sub_id={Sub site ID}&country={Country code}&install_finish_time={Install timestamp}&click_timestamp={Click timestamp}&pea_chain={Adset}&conversion_timestamp={Timestamp}&postback_id={Postback ID}&os_name={Platform}&sale_amount={Event revenue USD}&rejected_reason_value={Blocked reason value}&rejection_reason={Blocked reason}
In-App event postback for Android / IOS:
https://track.yournetwork.swaarm-clients.com/postback?publisher_sub_id={Sub site ID}&country={Country code}&install_finish_time={Install timestamp}&click_timestamp={Click timestamp}&pea_chain={Adset}&conversion_timestamp={Timestamp}&postback_id={Postback ID}&os_name={Platform}&sale_amount={Event revenue USD}&event_id={Event name}&rejected_reason_value={Blocked reason value}&rejection_reason={Blocked reason}
Note: We have used the af_adset parameter to pass the {pea.chain} information, but the af_sub_siteid or the af_ad parameters can be also be used for the same depending on the advertiser's requirement.
Documentation Link: Appsflyer - Advanced Privacy Integration
Adjust
Adjust sample tracking link:
https://app.adjust.com/trck123?campaign=coolgame_iOS&adgroup={publisher.id}_{publisher.subId}&creative={publisher.creative}&idfa={device.ids.idfa}&user_agent={user.encoded_ua}&tracker_limit=100000&install_callback=https%3A%2F%2Ftrack.yournetwork.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26idfa%3D%7Bidfa%7D%26gaid%3D%7Bgps_adid%7D%26city%3D%7Bcity%7D&event_callback_event1=http%3A%2F%2Ftrack.yournetwork.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26our_event_type_id%3D293&rejected_install_callback=https%3A%2F%2Ftrack.yournetwork.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26status%3Drejected%26idfa%3D%7Bidfa%7D%26gaid%3D%7Bgps_adid%7D%26city%3D%7Bcity%7D%26rejection_reason%3D%7Brejection_reason%7D
To track quality events for CPI campaigns and monetization events for CPA campaigns, both "our_event_type_id" and "event_id" can be used. "our_event_type_id" parameter should contain the swaarm generated event ID as follows,
If you wish to set up the postback based on the event_id which is called Adv.Event_type ID on the Event setup, then you can replace our_event_type_id%3D293 with event_id%3Dpurchase in the Offer tracking link.
Here you can find the additional Attribution link parameters supported by Adjust
Global Install and in-app event postbacks Creation (Adjust):
There is also an option for Adjust whereas with a technical integrated partner, you can share the postback template with Adjust to keep them saved on their end.
Global install postback (Android):
|
Global install Postback (iOS):
|
In-app event Postback for both OS:
|
To get some more information through your postback, you can always check these two helpful articles to adjust your tracking URL accordingly.
Documentation Link: Adjust Integration with Swaarm
Branch
To initiate this integration, you need to send the following:
- Attribution link template
- Postback URLs with Branch supported macros
Branch attribution link Template:
https://branchster.app.link/abcxyz?%243p=partner_id&%24aaid={device.ids.gaid}&%24idfa={device.ids.gaid}&~click_id={id}&~secondary_publisher={publisher.id}¶meter1={publisher.subId}¶meter2={YYY}¶meter3={ZZZ}
Install postback for Android:
https://track.yournetwork.swaarm-clients.com/postback?click_id=${ (last_attributed_touch_data.~click_id)! }&gaid=${ (user_data.aaid)! }&idfa=${ (user_data.idfa)! }
Install postback for iOS:
https://track.yournetwork.swaarm-clients.com/postback?click_id=${ (last_attributed_touch_data.~click_id)! }&gaid=${ (user_data.aaid)! }&idfa=${ (user_data.idfa)! }
In-App event postback for both OS:
https://track.yournetwork.swaarm-clients.com/postback?event_id=${(name)!}&click_id=${ (last_attributed_touch_data.~click_id)! }&gaid=${ (user_data.aaid)! }&idfa=${ (user_data.idfa)! }&country=${ (user_data.geo_country_code)! }
Docuemntation Link: Branch Integration with Swaarm
Kochava
Global install Postback for iOS:
https://track.yournetwork.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&idfa={idfa}&tracker_name={tracker_name}&status={traffic_validated}
Global install Postback for Android:
https://track.yournetwork.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&gaid={adid}&tracker_name={tracker_name}&status={traffic_validated}
In-app event Postback for iOS:
https://track.yournetwork.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&our_event_type_id={network_name.event_type_id}&idfa={idfa}&tracker_name={tracker_name}&status={traffic_validated}&event_id={event_name}&event_name={event_name}
In-app event Postback for Android:
https://track.yournetwork.swaarm-clients.com/postback?click_id={click/imp_id}&impression_based={is_viewthrough}&our_event_type_id={network_name.event_type_id}&gaid={adid}&tracker_name={tracker_name}&status={traffic_validated}&event_id={event_name}&event_name={event_name}
To track quality events for CPI campaigns and monetization events for CPA campaigns, we recommend using "our_event_type_id" parameter as an event tracking parameter that will contain the swaarm generated event ID.
Documentation Link: Kochava integration with Swaarm
Singular
Global Install and in-app event postback (singular):
Singular supports Install and event postback separately. The main difference should be in the event type ID parameter. Additionally, they also support revenue postback separately. Here we have suggested some templates that can be used.
Install Postback template
https://yournetwork.com/postback?click_id={cl?yournetwork}&gaid={AIFA}&city={CITY}&conversion_timestamp={UTC}&idfa={IDFA}
Event Custom Postback template
https://yournetwork.com/postback?event_id={EVTNAME}&click_id={cl?yournetwork}&gaid={AIFA}&city={CITY}&conversion_timestamp={UTC}
Do note: The event will be tracked based on the Singular event name, so it should be placed on the Swaarm event page in Adv.EventType ID section as follows:
Revenue Event template:
https://yournetwork.com/postback?sale_amount={AMOUNT}&event_id={EVTNAME}&click_id={cl?yournetwork}&gaid={AIFA}&city={CITY}&conversion_timestamp={UTC}
Explanation:
yournetwork: Own postback domain/subdomain needs to be adjusted
New MMP integration:
If you would like us to onboard a new MMP or any feature of an existing integrated MMP that needs additional integration, please use the following link and share the required information.
Our team will notify you once the integration is done.
Note:
Documentation Link: Singular Integration with Swaarm
Other Important Links and Documentation