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.
The correct callback parameter for your callback type.
The server endpoint URL where you want to receive data.
Adjust placeholders for the data points that you want to record.
Macros for the data points that you want to share.
Partner parameters (if applicable) to receive information about in-app events or sessions from your clients.
Note:
When you integrate with Campaign Lab, we ask you to share your callback URLs and macros. We append your callback URLs (except for event callbacks) and macros when your client generates the link URL. For event callbacks, you need to append the event token to the event callback parameter. In this case, we recommend that you use the Encoding tool. If you have any questions, contact integration@adjust.com.
Callback parameters
Use callback parameters to append different types of callbacks to the link URL.
Important:
If you're using Branded Links or Universal Links, you must prefix the callback parameter with adj_. For example: use adj_install_callback for the install_callback parameter.
Warning:
You cannot change the callback parameter syntax.
The following table lists callback parameters for different callback types:
Callback type
Callback parameter
Install
install_callback
Reattribution
reattribution_callback
Conversion (Includes installs and reattributions)
conversion_callback
Session
session_callback
Event You need to append event tokens to the callback parameter. Request your client to share this event token with you.
event_callback_<event_token>
Rejected install
rejected_install
Rejected reattribution
rejected_reattribution
Note:
If required, use the click_callback and impression_callback callback parameters to set up click callbacks and impression callbacks, respectively.
Callback URL/endpoint
The callback URL or endpoint determines where Adjust sends your data. It is your server endpoint URL. You can add this callback URL to an Adjust link URL to receive data related to installs, sessions, reattributions or in-app events.
Note:
Make sure that you specify the server endpoint URL/domain name as the callback URL. Adjust does not support an IP address in the callback URL for security reasons. Example: If you use http://1.2.3.4:80/xxxxx as the callback URL, Adjust servers would reject the incoming click.
You can add several callback URLs for one callback parameter by separating encoded callback URLs with a "+" sign.
Example: One callback URL
In the following example, https://mynetworkserver.com/callback is the callback URL for install callback.
In the following example, http://mynetworkserver.com/callback and http://myothernetworkserver.com/install are the callback URLs separated by "+" sign for install callback.
Adjust placeholders for partners are macros that let Adjust dynamically add user or engagement data to your callback string. You can add as many parameters and placeholders to your callback string as you like—just separate each key-value pairing with an ampersand (&).
For example, use the {idfa} placeholder to receive the identifier of the iOS device with your callbacks.
Tip:
Use the Encoding tool to generate your final encoded URL.
Do not encode dynamic partner macros. If you encode your macros, the servers will not recognize these macros and will not populate any necessary values.
Partner parameters
OPTIONAL
Use partner parameters to receive additional information about in-app events or sessions from your clients. It is up to the client to share this additional data with you.
The placeholder for partner parameters is {partner_parameters}. When you add this placeholder to your callback URL, you receive an encoded JSON payload of customized parameters from your client's SDK.
