Ad spend API
Integrate with Adjust's ad spend API and your clients will receive fully automated ad spend data that is more accurate, transparent, and granular than ever before. Ad spend data can be sent asynchronously within a 7-day window following a click, impression, or install. Find out the requirements and process for integrating with our Adjust ad spend API.
To integrate with the Adjust ad spend API, you will need to set up your servers to send a set of mandatory parameters to Adjust through an HTTP POST request to our designated endpoint.
Note: You can send ad spend data to Adjust at any time within a 7-day window following an engagement.
|cpi||Price model—this must be either ||Yes|
|usd||ISO 4217 currency code. See our full list of supported currencies.||Yes|
|1.99||Float value for the cost|
Maximum: 5 decimal places
|3P4OXS8dMAQbqn4Y||A unique value for matching cost information to an engagement|
Minimum: 12 characters
Maximum: 256 characters
|my_network||A label used for logging and debugging|
Maximum: 128 characters
curl -d "cost_type=cpi&cost_currency=usd&cost_amount=2&cost_id=abc123_company_name_test_1&tag=company_name_test" -X POST https://app.adjust.com/cost
If your request was successful, you will receive an
OK response. If there is a formatting issue, you will receive a
Bad Request response. If you are unsure of how to correctly format your request, please contact our integrations team: email@example.com.
cost_id allows you to send us a unique value between 12 and 256 characters in length. We use the
cost_id parameter to accurately match the cost data we receive with a click or impression.
- You can use your pre-existing
- Note: Your
cost_idvalue must be sent using the
cost_idparameter (even if you have included this value with another parameter)
- Note: Your
- To avoid matching a value from one of our other network partners, the
cost_idvalue must be as unique as possible. We recommend you use a universally unique identifier (UUID) or prefix the ID with your company name (e.g.,
- If you do not generate your own click or impression IDs, then you can combine two or more placeholders to form an ID. E.g., for CPI, you could combine the user’s IDFA and the app ID.
To transmit CPM data to Adjust, send
cost_id through the impression tracker URL and refer to it in the ad spend API call. Ensure that you send the CPM with each impression (i.e., the impression cost x1000).
Once you have configured your servers to send the required parameters (and any optional parameters), notify Adjust by reaching out to firstname.lastname@example.org. We can then being the testing phase of the integration.
We will provide you with a series of tests, so that you can check for discrepancies on the different cost types and spot any problems before the integration goes live. We will also conduct tests on our backend to ensure the API integration is functioning as expected.
Once all of these tests have achieved satisfactory results, we will follow up with you and your clients, and introduce you into our list of integrated ad spend partners, making you an official Adjust ad spend API partner.