Adjust Upload Config enables Swaarm to send ad spend data to Adjust using the Adjust Partner Ad Spend Push API. Once configured, advertisers using Adjust as their MMP can see accurate cost data in their Adjust dashboards for campaigns running through your network.
ℹ️ Adjust accepts ad spend data for up to 7 days after the engagement (click or impression) occurs.
Prerequisites
Before cost upload can work, your network needs to be set up as an integrated ad spend partner with Adjust. Contact wizards@adjust.com to set up partner credentials and go through Adjust's integration testing process. Once testing is complete, Adjust adds your network to their list of integrated ad spend partners.
Configuration
Setting up the Adjust Upload Configuration on Swaarm Offer:
Go to Offer → Edit → Integrations tab → Adjust Upload Config.
Click Save.
Field | What to enter |
Tag | A label used by Adjust for logging and debugging. Maximum 128 characters. We recommend using a value that identifies your network and offer - for example |
Cost Type | The pricing model: - CPC (cost per click) |
How Cost Matching Works
Adjust uses a unique cost_id to match uploaded cost data with the corresponding engagement or event. For cost attribution to work correctly:
The engagement or event tracked by Adjust must contain a unique
cost_id.Swaarm must send the corresponding
cost_idwhen uploading cost data through the Partner Ad Spend Push API.
If the values do not match, Adjust may receive the cost upload but will not be able to attribute it to the corresponding install or event.
CPI Cost Uploads
For CPI offers, a unique cost_id parameter should be added to the Adjust tracking link, which should be mapped with Swaarm macro {id}
Example tracking URL:
https://app.adjust.com/abc1234?...&cost_id={id}
When an install is tracked, Swaarm sends a cost upload request containing the same
cost_id.Adjust uses this identifier to match the install with the uploaded cost.
⚠️For CPI setup: Ensure the segment cost_id={id} is included in the Adjust tracking URL. Without this value, Adjust cannot attribute uploaded install costs.
CPE Cost Uploads
For CPE offers, Adjust generates a unique {event_cost_id} value for each event and sends it to Swaarm via the event callback URL.
Example callback:
...&event_callback_eventToken=https://track.yournetwork.swaarm-clients.com/postback?partner_parameters={event_cost_id}
Swaarm stores the received value and uses it as the
cost_idwhen uploading event costs to Adjust.Adjust then uses this value to match the event with the uploaded cost.
⚠️ For CPE setups: Ensure that the segment partner_parameters={event_cost_id} is included in the Adjust event callbacks. Without this value, Adjust cannot attribute uploaded event costs.
What Swaarm Sends
For each engagement, Swaarm sends a POST request to Adjust's /cost endpoint with the following data:
Parameter | What Swaarm sends |
| The cost type configured above (cpi / cpa) |
| Currency of the payout |
| The payout amount for this engagement |
| A unique identifier for this engagement - used by Adjust to match the cost data to the click or impression |
| The tag configured above |
Important notes
⚠️ Payout changes are not retroactive - if the payout on the offer changes after cost data has already been pushed to Adjust, the previously uploaded data will not be updated. Only new cost data going forward will use the updated payout values.