Skip to main content

Adjust

This is a setup guide for the Adjust source connector which ingests data from the reports API.

Prerequisites

An API token is required to get hold of reports from the Adjust reporting API. See the Adjust API authentication help article on how to obtain a key.

As Adjust allows you to setup custom events etc that are specific to your apps, only a subset of available metrics are made pre-selectable. To list all metrics that are available, query the filters data endpoint. Information about available metrics are available in the Datascape metrics glossary.

Full Metrics Listing

Take a look at the filters data endpoint documentation to see available filters. The example below shows how to obtain the events that are defined for your apps (replace the API_KEY with the key obtained in the previous step):

curl --header 'Authorization: Bearer API_KEY' 'https://dash.adjust.com/control-center/reports-service/filters_data?required_filters=event_metrics' | 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 API key obtained in the previous step.
  5. For Ingestion Start Date, enter a date in YYYY-MM-DD format (UTC timezone is assumed). Data starting from this date will be replicated.
  6. In the Metrics to Ingest field, select the metrics of interest to query.
  7. Enter any additional, custom metrics, to query in the Additional Metrics box. Available metrics can be listed as described in the Prerequisites section. These selected metrics are assumed to be decimal values.
  8. In the Dimensions field, select the dimensions to group metrics by.
  9. Click Set up source.

Supported sync modes

The source connector supports the following sync modes:

  • Full Refresh
  • Incremental

Reference

Config fields reference

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

Changelog

Expand to review
VersionDatePull RequestSubject
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.