Adjust
Send conversion and event data to Adjust for mobile attribution, campaign measurement, and fraud prevention.
This integration is currently in beta. Configuration and behaviour may change.
Prerequisites
Complete these steps in the Adjust dashboard before configuring Signal.
Create an Adjust account
Sign up at adjust.com and log in to the Adjust dashboard.
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
Signal events are mapped to Adjust S2S events via your blueprint. Common mappings include:
| Signal Event | Adjust Mapping | Notes |
|---|---|---|
purchase | S2S event with revenue | Requires event_token, revenue, and currency fields |
add_to_cart | S2S event | Map to a dedicated event token for cart actions |
sign_up | S2S event | Map to a registration event token |
custom | S2S event | Any custom event token you have defined in Adjust |
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.
Testing
- Set the
environmentto sandbox in your integration configuration. - Send a test event through Signal (use the Test Event button in the integration detail page or fire a test from your site).
- Open the Adjust Testing Console (under App Settings) and verify the event appears.
- Check the Live Logs in Signal to confirm delivery status is
200 OK. - Once verified, switch
environmentto 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.