Dynamic callback parameters

Dynamic callback parameters (DCPs) let you send custom campaign parameters at click or impression time. Use them to collect user-specific data for your internal system and receive network partner macros beyond Adjust's campaign parameters (campaign, adgroup, creative).

Before you begin

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

Requirements

Availability

Dynamic callback parameters work with server callbacks and CSV uploads for the following triggers: global, click, impression, install, rejected install, reattribution, rejected reattribution, reattribution reinstall, session, event, SAN engagement, GDPR, ad revenue, ad spend, and attribution update callbacks.

How dynamic callback parameters work

A dynamic callback parameter has two parts that share one name. In your link, it is a parameter. In your raw data export, it is a placeholder that Adjust replaces with the parameter's value when the engagement happens.

WhereWhat you addFormatExample
Link (Campaign Lab)ParameterName only, no prefixcampaign_name_3
Raw data export (AppView)Placeholderdcp_ prefix, in curly braces{dcp_campaign_name_3}

Set up dynamic callback parameters

Important:
You need to define and append dynamic callback parameters to your Adjust link and include them in your raw data export setup.

Step 1: In your raw data export

  1. Choose a name for your dynamic callback parameter, for example campaign_name_3.
  2. Add the dcp_ prefix to create the placeholder: dcp_campaign_name_3.
  3. In AppView, in your cloud storage setup, edit your server callback URL or CSV definition.
  4. Select Add a placeholder and type dcp_campaign_name_3, then select Add.
  5. Select Save.

Example: server callback URL

Callback URL with placeholders:

  • https://my.server.endpoint.com/adjust-callback?your_name={dcp_campaign_name_3}

Callback URL populated with values:

  • https://my.server.endpoint.com/adjust-callback?your_name=summer_sale_video

The name before the equals sign (your_name) is the label that your server expects. It is unrelated to dynamic callback parameters, so you can use any label your system understands. Adjust replaces the placeholder after the equals sign with the actual value when sending the callback.

Example: CSV definition

Add the placeholder just alongside standard placeholders such as {gps_adid} and {installed_at}:

Step 2: In your link

  1. Under Campaign Lab, find your link and copy the link URL.
  2. Paste your link URL into your preferred text editor (e.g., Notepad, TextEdit, or Google Docs) so you can add the parameter. Example link:
    • https://my-link.go.link?adj_t=abc123
  3. Add & and the parameter name without the dcp_ prefix, and set its value to the macro your ad network provides or the one your system can fill in. Example link:
    • https://my-link.go.link?adj_t=abc123&campaign_name_3=<your_macro>
  4. Share the link with your ad network so they use it in their campaigns, or place it in your own system (for example, your website).

Once both steps are done, Adjust receives the custom values at engagement time and includes them in your server callbacks and cloud storage uploads.

Important:
Your parameter names must not start with adj_ or adjust_.