Overview
This article covers the attribution link template and postback URL setup for integrating Adjust with Swaarm. The advertiser using Adjust usually shares a 6-7 digit tracker and a 6-digit event token (if required) with you, which you use to generate the tracking link via the Adjust Partner Dashboard.
ℹ️
For the full list of Swaarm macros and postback parameters → Advertiser Tracking Details
Full list of Adjust postback macros → Adjust Postback Macros for Integrated Partners
For Adjust partner link generation → Adjust Encoding Tool
Attribution Link Setup
⚠️ Adjust requires postback URLs embedded in the tracking link to be encoded - otherwise the Adjust server might fail to read the parameters and tracking might not work correct. Use the Adjust Encoding Tool to generate your tracking URL.
Example: Tracking an Install and a Purchase event for an offer named "coolgame_iOS". The advertiser shared a tracker trck123 and an event token xy123z for the Purchase event.
Step 1 - Add Your Adjust Link
In the Adjust Encoding Tool, insert your tracker with the placeholders you want to pass additional information through:
https://app.adjust.com/trck123?campaign=coolgame_iOS&adgroup={publisher.id}_{publisher.subId}&creative={publisher.creative}&idfa={device.ids.idfa}&gps_adid={device.ids.gaid}&user_agent={user.encoded_ua}&tracker_limit=100000
Step 2 - Add Your Callback URLs
Event callback (for event 'Purchase' with token
xy123z):
https://track.{yournetwork}.swaarm-clients.com/postback?click_id={id}&event_id=xy123z⚠️ Replace {yournetwork} with your own Swaarm postback domain.
Install callback:
https://track.{yournetwork}.swaarm-clients.com/postback?click_id={id}&idfa={idfa}&gaid={gps_adid}&city={city}⚠️ Replace {yournetwork} with your own Swaarm postback domain.
Rejected install callback:
https://track.{yournetwork}.swaarm-clients.com/postback?click_id={id}&status=rejected&idfa={idfa}&gaid={gps_adid}&city={city}&rejection_reason={rejection_reason}⚠️ Replace {yournetwork} with your own Swaarm postback domain.
Step 3 - Use the Generated URL
Once all callbacks are added, Adjust generates a complete URL combining the tracker and all callback parameters. Copy this generated URL and use it as the offer tracking URL in Swaarm.
Final tracking link will look as this -
https://app.adjust.com/trck123?campaign=coolgame_iOS&adgroup={publisher.id}_{publisher.subId}&creative={publisher.creative}&idfa={device.ids.idfa}&gps_adid={device.ids.gaid}&user_agent={user.encoded_ua}&tracker_limit=100000&install_callback=https%3A%2F%2Ftrack.bestagency.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26idfa%3D%7Bidfa%7D%26gaid%3D%7Bgps_adid%7D%26city%3D%7Bcity%7D&rejected_install_callback=https%3A%2F%2Ftrack.bestagency.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&event_callback_xy123z=https%3A%2F%2Ftrack.bestagency.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26event_id%3Dxy123zEvent Setup
There are 2 ways to track events with Adjust, depending on how you want to manage event identifiers:
Option 1 - Use the Adjust event token
Set the Adv. EventType ID on the Swaarm event to the Adjust event token (e.g.
xy123z)In the postback, use the
event_idparameter with the matching token value:
&event_callback_xy123z=https%3A%2F%2Ftrack.bestagency.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26event_id%3Dxy123z
Option 2 - Use the Swaarm event ID
Create the event in Swaarm and note its Swaarm-generated Event ID (e.g.
9864)In the postback, use the
our_event_type_idparameter with the Swaarm event ID as the value:
&event_callback_xy123z=https%3A%2F%2Ftrack.bestagency.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26our_event_type_id%3D9864
Global Postback Setup (Technical Integrated Partners)
If you are a technically integrated partner with Adjust, you can share a postback template directly with Adjust so it's saved on their end, rather than configuring it per-tracker.
Global install postback (Android)
https%3A%2F%2Ftrack.{yournetwork}.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26gaid%3D%7Bgps_adid%7D%26city%3D%7Bcity%7DGlobal install postback (iOS)
https%3A%2F%2Ftrack.{yournetwork}.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26idfa%3D%7Bidfa%7D%26city%3D%7Bcity%7DIn-app event postback (both OS)
http%3A%2F%2Ftrack.{yournetwork}.swaarm-clients.com%2Fpostback%3Fclick_id%3D{id}%26our_event_type_id%3D293⚠️ Replace {yournetwork} with your own Swaarm postback domain.
For more details on adjusting your tracking URL further: