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 GET syntax 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'll 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

Global callbacks

A global callback is a main callback for every trigger that Adjust measures, for example, clicks, installs, sessions, and more. This is the fastest, easiest 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 lot of data, especially impressions and clicks. If you want to decrease the amount of data that Adjust sends to your business intelligence system, then you should 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, you need to 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 out guide on recommended placeholders.

Guided setup

  1. 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.
  2. Under Server callbacks, select Add callback > Guided setup.
  3. In the Callback trigger list, select the activity or event that would trigger the callback.
  4. In the Server endpoint field, enter an endpoint URL where you can receive your data.
  5. (Optional) Select Add a condition to add a condition in combination with placeholders and values. The callback would be triggered only if the condition is satisfied.
  6. Now, select Add a placeholder to dynamically include user or engagement data in your callback. You can add multiple placeholders at this point.
  7. Select Create callback URL to generate the encoded callback URL.

Manage your callbacks

Once you've built your callback URL, you can view it on the Server callbacks overview page. You can perform the folowing 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.