Adjust
Sync aggregated metrics from the Adjust Report Service API with the Adjust source connector. It’s available for Airbyte Self-Managed.
Prerequisites
You need an Adjust API token. In the Adjust dashboard, go to Account settings > My profile and copy your API Token. If you use single sign-on (SSO), API tokens aren’t available in the dashboard. Contact your Adjust representative or [email protected] for help. See Report service API authentication.
If you install connector version 0.2.2 as a Python package, use Python 3.11, 3.12, or 3.13. Container deployments include their own Python runtime.
Find more metrics
The Metrics to ingest field provides a fixed set of metrics. For other metrics, including app-specific event and cohort metrics, use Additional metrics for ingestion. See the Datascape metrics glossary for metric definitions.
Query the Events endpoint to find event slugs for your apps. Replace API_TOKEN with your Adjust API token. Use the returned id values as metric names:
curl --header 'Authorization: Bearer API_TOKEN' 'https://automate.adjust.com/reports-service/events' | jq
Set up the Adjust source
- Click Sources, then click + New source.
- On the Set up the source page, select Adjust from the Source type dropdown.
- Enter a name for your new source.
- For API Token, enter your Adjust API token.
- For Ingest Start Date, enter the sync start date. For JSON configuration, use a UTC timestamp such as
2024-01-01T00:00:00Z. - For Metrics to ingest, select at least one metric.
- (Optional) For Additional metrics for ingestion, enter any additional metric names. The connector types these columns as numbers.
- For Dimensions, select at least one dimension for grouping metrics. The connector always adds
dayas a dimension. - (Optional) Turn on Until Today to end the requested date range on the current UTC date, rather than the following date. This option is off by default.
- Click Set up source.
Supported streams
The connector syncs one stream, AdjustReport, from the Adjust JSON report endpoint. It reads the response’s rows array, not totals or warnings. It groups metrics by day and your selected dimensions. The discovered schema includes day, your selected predefined metrics and dimensions, and any additional metrics.
Supported sync modes
The source connector supports these sync modes:
- Full Refresh
- Incremental
For incremental syncs, the connector uses day as the cursor and requests data in one-day intervals.
Limitations
The Report Service API allows 50 requests per second for each source IP address, with a 100-request burst allowance. Clients sharing a NAT gateway or proxy also share this limit. Adjust returns 429 Too Many Requests when you exceed the limit. See Report service API rate limits.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.2.2 | 2026-11-11 | 90889 | Raise minimum supported Python version to 3.11 |
| 0.2.1 | 2026-11-10 | 78584 | Update dependencies |
| 0.2.0 | 2026-11-03 | 90863 | Upgrade to airbyte-cdk 7 and Python 3.13 base image |
| 0.1.33 | 2025-02-01 | 52916 | Update dependencies |
| 0.1.32 | 2025-01-25 | 52196 | Update dependencies |
| 0.1.31 | 2025-01-18 | 51733 | Update dependencies |
| 0.1.30 | 2025-01-11 | 51272 | Update dependencies |
| 0.1.29 | 2025-01-04 | 50901 | Update dependencies |
| 0.1.28 | 2024-12-28 | 50439 | Update dependencies |
| 0.1.27 | 2024-12-21 | 50151 | Update dependencies |
| 0.1.26 | 2024-12-14 | 49030 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 0.1.25 | 2024-10-28 | 47046 | Update dependencies |
| 0.1.24 | 2024-10-12 | 46851 | Update dependencies |
| 0.1.23 | 2024-10-05 | 46411 | Update dependencies |
| 0.1.22 | 2024-09-28 | 46147 | Update dependencies |
| 0.1.21 | 2024-09-21 | 45741 | Update dependencies |
| 0.1.20 | 2024-09-14 | 45511 | Update dependencies |
| 0.1.19 | 2024-09-07 | 45222 | Update dependencies |
| 0.1.18 | 2024-08-31 | 44985 | Update dependencies |
| 0.1.17 | 2024-08-24 | 44751 | Update dependencies |
| 0.1.16 | 2024-08-17 | 44266 | Update dependencies |
| 0.1.15 | 2024-08-12 | 43828 | Update dependencies |
| 0.1.14 | 2024-08-10 | 43492 | Update dependencies |
| 0.1.13 | 2024-08-03 | 43055 | Update dependencies |
| 0.1.12 | 2024-07-27 | 42698 | Update dependencies |
| 0.1.11 | 2024-07-20 | 42155 | Update dependencies |
| 0.1.10 | 2024-07-13 | 41852 | Update dependencies |
| 0.1.9 | 2024-07-10 | 41055 | Update datetime format |
| 0.1.8 | 2024-07-10 | 41460 | Update dependencies |
| 0.1.7 | 2024-07-09 | 41182 | Update dependencies |
| 0.1.6 | 2024-07-06 | 40947 | Update dependencies |
| 0.1.5 | 2024-06-25 | 40470 | Update dependencies |
| 0.1.4 | 2024-06-24 | 39911 | Migrate connector to low code |
| 0.1.3 | 2024-06-21 | 39923 | Update dependencies |
| 0.1.2 | 2024-06-06 | 39287 | [autopull] Upgrade base image to v1.2.2 |
| 0.1.1 | 2024-05-20 | 38373 | [autopull] base image + poetry + up_to_date |
| 0.1.0 | 2022-08-26 | 16051 | Initial version. |