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.
Ad spend API requirements
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.
Endpoint URL
https://app.adjust.com/cost
Parameters
Parameter | Example | Description | Required |
---|---|---|---|
cost_type | cpi | Price model—this must be either cpc , cpi , or cpm | Yes |
cost_currency | usd | ISO 4217 currency code. See our full list of supported currencies. | Yes |
cost_amount | 1.99 | Float value for the cost Maximum: 5 decimal places | Yes |
cost_id | 3P4OXS8dMAQbqn4Y | A unique value for matching cost information to an engagement Minimum: 12 characters Maximum: 256 characters | Yes |
tag | my_network | A label used for logging and debugging Maximum: 128 characters | Yes |
Example request
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: wizards@adjust.com.
What is cost_id
?
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.
Best practices:
- You can use your pre-existing
click_id
orimpression_id
- Note: Your
cost_id
value must be sent using thecost_id
parameter (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_id
value 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.,network_name_848dsf4939fgwjn028erg4
). - 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.
Tracking CPM with Adjust
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).
Finalizing your integration with the Adjust ad spend API
Once you have configured your servers to send the required parameters (and any optional parameters), notify Adjust by reaching out to wizards@adjust.com. 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.