Skip to main content

Adjust

Availability
Available CoreNot available StandardNot available PlusNot available ProNot available Enterprise FlexAvailable PyAirbyte
Connector type
Available Data replicationNot available Agent(learn more)
Support Level
Marketplace
Connector Version
0.2.2 (last updated 4 days ago)
CDK Version
7.47.0
Sync Success Rate
Medium
Usage Rate
Medium
Data workers used
0.2 per sync (Learn more)
Definition ID
d3b7fa46-111b-419a-998a-d7f046f6d66d

The Adjust source connector syncs aggregated metrics from the Adjust Report Service API. 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 your organization uses 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 additional metrics​

The Metrics to ingest field offers a fixed set of metrics. For other metrics, including app-specific event metrics and cohort metrics, use Additional metrics for ingestion. See the Datascape metrics glossary for metric definitions.

To find event slugs for your apps, query the Events endpoint. Replace API_TOKEN with your Adjust API token, and 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 connector​

  1. Click Sources and then click + New source.
  2. On the Set up the source page, select Adjust from the Source type dropdown.
  3. Enter a name for your new source.
  4. For API Token, enter your Adjust API token.
  5. For Ingest Start Date, enter the start date for the sync. When supplying JSON configuration, use a UTC timestamp such as 2024-01-01T00:00:00Z.
  6. For Metrics to ingest, select at least one metric.
  7. (Optional) For Additional metrics for ingestion, enter any additional metric names. The connector types these columns as numbers.
  8. For Dimensions, select at least one dimension to group metrics by. The connector always adds day as a dimension.
  9. (Optional) Turn on Until Today to set the end of the requested date range to the current UTC date instead of the following date. This option defaults to off.
  10. 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. Metrics are grouped by day and your selected dimensions. The discovered schema includes day, the selected predefined metrics and dimensions, and any additional metrics.

Supported sync modes​

The source connector supports the following 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 per source IP address, with a burst allowance of 100 requests. Clients sharing a NAT gateway or proxy share this limit. Adjust returns 429 Too Many Requests when the limit is exceeded. See Report service API rate limits.

Reference​

Config fields reference

Field
Type
Property name
string
api_token
array<string>
dimensions
string
ingest_start
array<string>
metrics
array<string>
additional_metrics
boolean
until_today

Changelog​

Expand to review
VersionDatePull RequestSubject
0.2.22026-11-1190889Raise minimum supported Python version to 3.11
0.2.12026-11-1078584Update dependencies
0.2.02026-11-0390863Upgrade to airbyte-cdk 7 and Python 3.13 base image
0.1.332025-02-0152916Update dependencies
0.1.322025-01-2552196Update dependencies
0.1.312025-01-1851733Update dependencies
0.1.302025-01-1151272Update dependencies
0.1.292025-01-0450901Update dependencies
0.1.282024-12-2850439Update dependencies
0.1.272024-12-2150151Update dependencies
0.1.262024-12-1449030Starting 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.252024-10-2847046Update dependencies
0.1.242024-10-1246851Update dependencies
0.1.232024-10-0546411Update dependencies
0.1.222024-09-2846147Update dependencies
0.1.212024-09-2145741Update dependencies
0.1.202024-09-1445511Update dependencies
0.1.192024-09-0745222Update dependencies
0.1.182024-08-3144985Update dependencies
0.1.172024-08-2444751Update dependencies
0.1.162024-08-1744266Update dependencies
0.1.152024-08-1243828Update dependencies
0.1.142024-08-1043492Update dependencies
0.1.132024-08-0343055Update dependencies
0.1.122024-07-2742698Update dependencies
0.1.112024-07-2042155Update dependencies
0.1.102024-07-1341852Update dependencies
0.1.92024-07-1041055Update datetime format
0.1.82024-07-1041460Update dependencies
0.1.72024-07-0941182Update dependencies
0.1.62024-07-0640947Update dependencies
0.1.52024-06-2540470Update dependencies
0.1.42024-06-2439911Migrate connector to low code
0.1.32024-06-2139923Update dependencies
0.1.22024-06-0639287[autopull] Upgrade base image to v1.2.2
0.1.12024-05-2038373[autopull] base image + poetry + up_to_date
0.1.02022-08-2616051Initial version.
Was this page helpful?