Adjust

Send conversion and event data to Adjust server-to-server for mobile attribution, campaign measurement, and fraud prevention.

⚠️

This blueprint is currently alpha — schema and behaviour may change before GA.

Prerequisites

Complete these steps in the Adjust dashboard before configuring Signal.

Create an Adjust account

Create an app

Navigate to Campaign Lab > All Apps and click Add app. Enter your app name, platform, and store URL.

Find your app token

Open the app you just created and go to Settings > App Settings. Copy the App Token shown at the top of the page.

Create event tokens

Navigate to Settings > Events within your app. Click Create Event for each conversion type you want to track (e.g. purchase, registration, add to cart). Note each Event Token.

Get your S2S security secret

Go to Settings > App Settings > S2S Security and enable S2S verification. Copy or generate your S2S Secret. This authenticates server-to-server API calls and prevents spoofed events.

Choose your environment

Decide whether to send events to the sandbox (for testing) or production environment. You can change this in Signal at any time.

Configuration

Field	Type	Required	Description
`app_token`	string	Yes	Your Adjust app token from App Settings.
`event_token`	string	Yes	The event token for the specific conversion type you want to track.
`s2s_secret`	secret	Yes	The S2S security secret for authenticating server-side API calls.
`environment`	select	Yes	Target environment: `sandbox` for testing or `production` for live traffic.

Signal Setup

Quick Setup

Navigate to Integrations in the sidebar.
Open the Integration Library tab.
Find Adjust or filter by Attribution.
Click Install, select a variant if available, and fill in the required fields.
Click Install Integration to create the integration with a ready-to-use default blueprint.

API Setup

curl -X POST http://localhost:8084/v1/admin/integration-catalog/adjust/install \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Adjust",
    "variant": "default",
    "config": {
      "app_token": "abc123def456",
      "event_token": "ev1abc",
      "s2s_secret": "your_s2s_secret",
      "environment": "sandbox"
    },
    "delivery_mode": "server_side"
  }'

Event Mapping

The Retail variant maps the following Datafly events to Adjust S2S events:

Datafly Event	Adjust Event	Notes
`Product Viewed`	`view_item`	Requires the matching `event_token` configured in Adjust
`Product Added`	`add_to_cart`	Requires the matching `event_token` configured in Adjust
`Order Completed`	`purchase`	Requires `revenue` and `currency`; map a dedicated revenue event token
Custom events	Passed through	Bind each custom event name to its Adjust event token via the blueprint

Identity

The default blueprint forwards the following identifiers to Adjust so attribution joins to the correct device:

Source	Adjust field
`vendor_ids.adjust_adid`	`adid`
`vendor_ids.gps_adid`	`gps_adid` (Android)
`vendor_ids.idfa`	`idfa` (iOS)
`context.ip`	`ip_address`
`context.user_agent`	`user_agent`

For mobile traffic, capture adid (Adjust’s device ID), gps_adid, or idfa from your app SDK and pass them via the Datafly mobile SDK. Web events that share a user with a mobile install can pass adid directly so Adjust joins the sessions.

Default consent category: advertising. Adjust is a paid-media measurement destination — gate it behind advertising consent in your CMP.

Each Adjust event type requires its own event token. Create separate event tokens in Adjust for each conversion action, then map them in your blueprint.

Verify it’s working

Set environment to sandbox in your integration configuration.
In the Signal Management UI, open your Adjust integration and watch the Live Events stream as you trigger events.
Open the Adjust Testing Console (under App Settings) and verify the event appears.
Confirm 200 responses in Signal’s Live Events log.
Once verified, switch environment to production for live traffic.

Troubleshooting

Symptom	Cause	Resolution
`401 Unauthorized`	Invalid or missing S2S secret	Verify `s2s_secret` matches the value in Adjust S2S Security settings.
`400 Bad Request`	Invalid app token or event token	Confirm `app_token` and `event_token` are correct and the event is active.
Events not appearing in Adjust	Wrong environment selected	Ensure `environment` matches where you are looking (sandbox vs production).
Duplicate events	Event sent more than once	Check your pipeline for duplicate triggers; Adjust deduplicates by device ID within a window.

Visit Adjust documentation for full API reference and credential setup instructions.

Blueprint

The Adjust blueprint version is 0.1.0 (alpha). It ships with a Retail variant covering product view, add-to-cart, and purchase events. Custom event tokens are added by editing the blueprint.