In this article, we are going to explain what the attribution link template and the postback URLs should look like for Swaarm MMP.

To initiate this integration you need to set-up the following:

Swaarm attribution link contains the minimum information to record the click and redirect the user to download the app. Additional parameters must be added to the link after the “?” character i.e. offer_id and pub_id, to record extra information and get back the information via the postback link. This is what the base attribution link looks like,

https://mmpnetworkname.trckswrm.com/click?offer_id=[Offer ID]&pub_id=[Publisher ID]

See below what the complete attribution link should look like after you have added additional Swaarm macros, and parameters for the install callback and any subsequent event such as event_1:

https://mmpnetworkname.trckswrm.com/click?offer_id=[Offer ID]&pub_id=[Publisher ID]&pub_sub_id={publisher.subId}&pub_click_id={id}&idfa={device.ids.idfa}&gaid={device.ids.gaid}&app={publisher.app}&creative={publisher.creative}&install_callback=INSERT_INSTALL_CALLBACK_URL&event_callback_event1=INSERT_CALLBACK_URL_FOR_EVENT

The next step is to add your callbacks in the callbacks section provided in the tracking links:

Install: https://track.yournetwork.swaarm-clients.com/postback?click_id={id}

Event: event1 - https://track.yournetwork.swaarm-clients.com/postback?click_id={id}&event_id=purchase

The last step is to add the callbacks to the base attribution links and to encode the callbacks.

The ultimate URL should look like the following link:

https://mmpnetworkname.trckswrm.com/click?offer_id=[Offer ID]&pub_id=[Publisher ID]&pub_sub_id={publisher.subId}&pub_click_id={id}&idfa={device.ids.idfa}&gaid={device.ids.gaid}&app={publisher.app}&creative={publisher.creative}&install_callback=https%3A%2F%2Ftrack.yournetwork.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}&event_callback_event1=https%3A%2F%2Ftrack.yournetwork.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26event_id%3Dpurchase

You can replace yournetwork with the name in your global postback.

To track quality events for CPI campaigns and monetization events for CPA campaigns, both "our_event_type_id" and "event_id" can be used. The "event_id" parameter should contain the Advertiser EventType ID field as follows:

If you wish to set up the postback based on the our_event_type_id with Swaarm's generated event ID in the Event setup, then you can replace event_id%3Dpurchase with our_event_type_id%3D293 in the Offer tracking link.

For the full list of Macros supported by Swaarm, click here