.png)
Adjust Integration Guide
Integrate Adjust with enterprise systems through REST APIs, selected callbacks, reporting services, and raw-data exports.
Adjust integration options at a glance
Adjust provides REST APIs for reporting, tracking, application and campaign-related operations, with endpoint availability determined by the product and account permissions. It also supports selected callback scenarios for attribution, sessions, reattribution, in-app events, ad revenue, and fraud-related data. Reporting and export services can support scheduled or batch extraction, while raw-data exports may deliver JSON, CSV, or other configured formats through callbacks or accessible destinations. Adjust uses token-based authentication, including API tokens and separate app or event tokens for some tracking scenarios. Martini can consume these APIs, receive callback requests, schedule incremental reports, transform data, and route normalized results to enterprise systems.
Common Adjust integration patterns
Common Adjust data objects used in integrations
Authentication and security considerations
Token-based authentication
Adjust uses token-based authentication for API services. API tokens, app tokens, and event tokens may serve different purposes, so the required credential should be confirmed for each endpoint.
Secrets and least privilege
Martini should store Adjust tokens, callback credentials, and downstream credentials as environment-managed secrets. Use the narrowest account permissions and rotate credentials without changing workflow logic.
Callback and data protection
Validate callback requests using the security options available for the configured Adjust feature. Minimize device identifiers and personal data, and apply authorization and retention controls before exposing normalized data through a Martini API.
Operational considerations for Adjust integrations
Rate limits and report size
Confirm limits for each Adjust API and control concurrency. Partition large reports, process pagination or asynchronous generation, and avoid repeatedly extracting unchanged historical periods.
Incremental synchronization
Use reporting dates, event timestamps, or supported watermarks with an overlap window. Reconcile overlapping results by stable dimensions and identifiers because attribution and revenue data can change after the original event.
Idempotency and callbacks
Callback delivery may be delayed, duplicated, or out of order. Persist acceptance records, generate deterministic keys, and use idempotent upserts before acknowledging or routing a notification.
Schema, time, and currency controls
Adjust dimensions and metrics vary by endpoint and product. Version internal schemas, validate required fields, explicitly configure time zones, and normalize currencies before financial aggregation.
Monitoring and testing
Monitor API latency, throttling, extraction counts, callback acceptance, rejected records, retry volume, and reconciliation differences. Test representative callbacks, report windows, privacy controls, and downstream failure scenarios before production release.
Why use Martini instead of scripts or point-to-point integrations?
Orchestrate more than an API call
Scripts can retrieve Adjust data, but enterprise integrations also need scheduling, callback intake, validation, transformation, routing, retries, and operational visibility. Martini coordinates these concerns in maintainable workflows.
Separate source and target models
Martini can map Adjust’s campaign, attribution, event, and report structures into canonical models instead of embedding point-to-point field logic in every consumer.
Reuse integration assets
Reusable workflows and APIs can standardize authentication, pagination, deduplication, error handling, and downstream delivery across multiple Adjust applications and reporting processes.
Expose controlled data services
Where several internal applications need Adjust data, Martini can expose a normalized API façade with controlled access rather than requiring each consumer to implement Adjust-specific authentication and data rules.