IntegrationsAttributionAdjust

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

FieldTypeRequiredDescription
app_tokenstringYesYour Adjust app token from App Settings.
event_tokenstringYesThe event token for the specific conversion type you want to track.
s2s_secretsecretYesThe S2S security secret for authenticating server-side API calls.
environmentselectYesTarget environment: sandbox for testing or production for live traffic.

Signal Setup

Quick Setup

  1. Navigate to Integrations in the sidebar.
  2. Open the Integration Library tab.
  3. Find Adjust or filter by Attribution.
  4. Click Install, select a variant if available, and fill in the required fields.
  5. 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 EventAdjust MappingNotes
purchaseS2S event with revenueRequires event_token, revenue, and currency fields
add_to_cartS2S eventMap to a dedicated event token for cart actions
sign_upS2S eventMap to a registration event token
customS2S eventAny 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

  1. Set the environment to sandbox in your integration configuration.
  2. Send a test event through Signal (use the Test Event button in the integration detail page or fire a test from your site).
  3. Open the Adjust Testing Console (under App Settings) and verify the event appears.
  4. Check the Live Logs in Signal to confirm delivery status is 200 OK.
  5. Once verified, switch environment to production for live traffic.

Troubleshooting

SymptomCauseResolution
401 UnauthorizedInvalid or missing S2S secretVerify s2s_secret matches the value in Adjust S2S Security settings.
400 Bad RequestInvalid app token or event tokenConfirm app_token and event_token are correct and the event is active.
Events not appearing in AdjustWrong environment selectedEnsure environment matches where you are looking (sandbox vs production).
Duplicate eventsEvent sent more than onceCheck your pipeline for duplicate triggers; Adjust deduplicates by device ID within a window.

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