We constantly publish updates to our documentation, which may not yet be available in your language. For the most current information, use the English version.

for Marketers

Set up server callbacks

You can set up server callbacks to receive advertising IDs, attribution details, app data, and more directly to your servers as raw data.

Before you begin

Here's what you need to know before getting started.

Requirements

Admin, Editor, or Custom Editor permissions
You need your own business intelligence solution or data warehouse to receive callback requests. Confirm that your server can receive all of your parameters and store all incoming data. The number of users in your app affects how fast your servers need to be. If you measure one-time events, like registrations, you receive one callback for each converting user. Callbacks for conversion events usually don't have a major impact on server bandwidth.
To make sure you only receive data from Adjust, allowlist our server IPs.

Callback types

You can set up callbacks for the following triggers:

Available triggers

A global callback is a main callback for every trigger that Adjust measures, for example, clicks, installs, sessions, and more. This is the fastest way to get the same data points for every activity Adjust measures since there is only one URL instead of several.

Note:

Global callbacks do not include the following activities:

Ad revenue
SAN clicks
SAN impressions
SKAdNetwork installs
SKAdNetwork events

You need to set up single activity callbacks for these activities.

Single activity callbacks

A single activity callback is a callback for one specific activity, for example, clicks. This is a great option if you only need data for that specific activity. In some cases the global callback can generate a large amount of data, especially impressions and clicks. If you want to decrease the amount of data that Adjust sends to your business intelligence system, set up single activity callbacks.

Note:

If you set up both global and single activity callbacks you receive two callbacks for the same activity, with one sent to each endpoint.

Multiple callbacks for the same activity

Adjust can send a single activity callback to as many endpoints as you want. To do this, separate each URL with a single space ( ).

Set up server callbacks

You can create server callbacks using the guided setup or classic setup. Adjust recommends using the guided setup to create callback URLs.

For help knowing what placeholders to use for a trigger, consult our guide on recommended placeholders.

Guided setup

Access the server callback setup from your app card or from the Data management tab of your app setup.
- (Admin, Editor, or Custom Editor permissions only) To set up a server callback from the app card, under AppView, select All apps. Find your app and select Server callbacks.
- To set up a server callback from the Data management tab of your app setup, under AppView, select All apps. Select your app, and then select the Data management tab.
Under Server callbacks, select Add callback > Guided setup.
In the Callback trigger list, select the activity or event that triggers the callback.
In the Server endpoint field, enter an endpoint URL where you can receive your data.
(Optional) Select Add a condition to add a condition in combination with placeholders and values. The callback triggers only if the condition is satisfied.
In the Request method field, select whether the callback uses GET or POST. The default is GET.
- When you select POST, you can enter key-value pairs as the request body using key=value format. Adjust encodes the body and sends it as a flat JSON object.
Select Add a placeholder to dynamically include user or engagement data in your callback. You can add multiple placeholders at this point.
Select Create callback URL to generate the encoded callback.

Classic setup

When you use the classic setup, you can directly edit the full callback string. The system now recognizes both GET and POST formats:

<METHOD>,<conditions>,<url>[,<body>]
POST bodies use key1=value1&key2=value2 and Adjust converts them into flat JSON.

You can enter multiple callbacks separated by a space. The default request method is GET unless you explicitly specify POST.

Manage your callbacks

Once you build your callback URL, you can view it on the Server callbacks overview page. You can perform the following tasks on your callback:

Select (Copy icon) to copy the callback URL.
Select (Duplicate icon) to duplicate the callback and open the classic setup.
Select (Delete icon) to delete the callback.
Select (Edit icon) to edit the callback URL using the classic setup.