Skip to main content

Adjust

Adjust is a mobile measurement and marketing analytics platform that helps app marketers measure attribution, in-app events, and campaign performance across channels. The Adjust Report Service API provides read-only access to aggregated analytics reports and event metadata, enabling teams to pull attribution, KPI, and in-app event data for analysis and reporting.

Adjust icon

Power end-to-end data operations for your Adjust API with Nexla. Our bi-directional Adjust connector is purpose-built for Adjust, making it simple to ingest data, sync it across systems, and deliver it anywhere — all with no coding required. Nexla turns API-sourced data into ready-to-use, reusable data products and makes it easy to send data to Adjust or any other destination. With comprehensive monitoring, lineage tracking, and access controls, Nexla keeps your Adjust workflows fast, secure, and fully governed.

Features

Type: API

SourceDestination

  • Seamless API Integration: Connect to any endpoint as source or destination without coding, with automatic data product creation
  • Visual Composition & Chaining: Build complex integrations using visual templates, chain API calls, and compose workflows with data validation and filtering
  • API Proxy: Expose curated slices of your data securely with a secure and customizable API proxy that validates and transforms data on the fly
  • Request optimization with intelligent batching, retry, and caching to minimize API calls and costs

Prerequisites​

Before creating an Adjust credential, you need to obtain your Adjust API token from the Adjust dashboard. The Adjust Report Service API uses bearer token authentication, with the token sent in the Authorization header using the Bearer prefix.

The API token is a static, per-user token tied to your Adjust dashboard user account. There is no documented token expiry or refresh, so the same token can be reused until you reset it.

To obtain your Adjust API token, follow these steps:

  1. Sign in to the Adjust dashboard at https://dash.adjust.com using your account credentials.

  2. Click the settings icon (gear) in the bottom-left corner of the dashboard.

  3. Select Account settings from the menu.

  4. Open the My profile tab.

  5. Locate your API Token in the User Details section, and click the copy button to copy the token to your clipboard.

  6. Store the API token securely, as you will need it to configure your Nexla credential. The token is sensitive information and should be kept confidential.

SSO Users

If your account is configured to use single sign-on (SSO), your API token is not available in the Adjust dashboard. SSO-configured users must request a token from their Adjust representative or by contacting support@adjust.com.

The API token is sent in the Authorization: Bearer {api_token} header for all requests to the Adjust Report Service API. You can reset the token at any time from the same My profile tab using the Reset API token option, which requires re-entering your account password. Resetting the token immediately invalidates the previous token, so any integrations using the old token must be updated. For complete information about authentication, see the Adjust Report Service API authentication documentation.

Authenticate​

Create a credential in Nexla​

  1. After selecting the data source type, click the Add Credential tile to open the Add New Credential overlay.

  2. Enter a name for the credential in the Credential Name field and a short, meaningful description in the Credential Description field.

  3. Enter your Adjust API token in the API Token field. This is the token you obtained from the Adjust dashboard under Account settings > My profile > API Token. The token is sent in the Authorization: Bearer {api_token} header for all API requests and authenticates Nexla with your Adjust account. The API token is sensitive information and must be kept confidential.

    Your Adjust API token can be found in the Adjust dashboard under Account settings > My profile > API Token, in the User Details section. SSO-configured users cannot view the token in the dashboard and must request it from their Adjust representative or support@adjust.com.

    If your API token is compromised, reset it immediately from the My profile tab using the Reset API token option, then update your Nexla credential with the new token. Resetting invalidates the previous token.

    For detailed information about authentication and the available reporting endpoints, see the Adjust Report Service API documentation.

  4. Click the Save button at the bottom of the overlay. The newly added credential will now appear in a tile on the Authenticate screen during data source creation.

Use as a data source​

To create a new data flow, navigate to the Integrate section, and click the New Data Flow button. Select the Adjust connector tile, then select the credential that will be used to connect to your Adjust account, and click Next; or, create a new Adjust credential for use in this flow.

Endpoint templates​

Nexla provides pre-built templates that can be used to rapidly configure data sources to ingest data from common Adjust endpoints. Each template is designed specifically for the corresponding Adjust endpoint, making data source setup easy and efficient. Select the endpoint from which this source will fetch data from the Endpoint pulldown menu. Available endpoint templates are listed in the expandable boxes below.

Get Report (JSON)

This endpoint template fetches an aggregated analytics report as JSON from the Adjust Report Service. The report columns are driven by the dimensions and metrics you choose, and the data rows are returned under the rows array. Use this template when you need attribution, KPI, or campaign performance data in a structured JSON format for analysis or reporting.

  • Enter a comma-separated list of dimensions to group by in the Dimensions field (e.g., app,day,country,os_name). Dimensions define how the report rows are grouped. The default value is app,day. See the Adjust dimensions reference for the complete list of available dimensions.
  • Enter a comma-separated list of metrics to return in the Metrics field (e.g., installs,sessions,revenue). Metrics define the measured values that appear in each report row. The default value is installs,sessions. See the Adjust metrics reference for the complete list of available metrics.
  • Enter the reporting date range in the Date Period field as start:end (e.g., 2024-01-01:2024-01-31) or as a relative range (e.g., -30d:-1d). The default value is -30d:-1d, which covers the previous 30 days through yesterday.

The report row schema is dynamic—the columns returned depend entirely on the dimensions and metrics you supply, so the output structure changes with your configuration. Nexla extracts each element of the rows array (path $.rows[*]) as an individual record.

For detailed information about available dimensions, metrics, date period formats, and the response structure, see the Adjust Report Service API reports documentation.

Get Report (CSV)

This endpoint template fetches the same aggregated analytics report as CSV rather than JSON. The first row of the response is the column header, and the remaining rows contain the report data. Columns are driven by the dimensions and metrics you choose. Use this template when a CSV format is preferred for downstream processing or when ingesting large reports.

  • Enter a comma-separated list of dimensions to group by in the Dimensions field (e.g., app,day,country,os_name). The default value is app,day.
  • Enter a comma-separated list of metrics to return in the Metrics field (e.g., installs,sessions,revenue). The default value is installs,sessions.
  • Enter the reporting date range in the Date Period field as start:end (e.g., 2024-01-01:2024-01-31) or as a relative range (e.g., -30d:-1d). The default value is -30d:-1d.

This template returns the report as CSV. The first row contains the column headers and subsequent rows contain the data; as with the JSON report, the columns are dynamic and depend on the dimensions and metrics supplied.

For detailed information about the CSV report format and available parameters, see the Adjust Report Service API CSV documentation.

Get Events

This endpoint template fetches the event metadata catalog from your Adjust account. It returns details for each configured in-app event, including the event id, name, short name, section, tokens, app token, and the SKAdNetwork flag. Use this template to retrieve your event token mapping for use in analysis or to enrich report data.

  • This endpoint automatically retrieves the full event metadata catalog accessible to your account. No additional configuration is required beyond selecting this endpoint template.
  • The response is a root-level JSON array of event objects. Nexla extracts each element of the array (path $[*]) as an individual record.

For detailed information about the event metadata fields and token mapping, see the Adjust Report Service API events documentation.

Once the selected endpoint template has been configured, click the Test button to the right of the endpoint selection menu to retrieve a sample of the data that will be fetched. Sample data will be displayed in the Endpoint Test Result panel on the right, allowing you to verify that the source is configured correctly before saving.

Manual configuration​

Adjust data sources can also be manually configured to ingest data from any valid Adjust Report Service API endpoint, including endpoints not covered by the pre-built templates—such as the Parquet or Pivot report endpoints—or custom query parameters. Select the Advanced tab at the top of the configuration screen, and follow the instructions in Connect to Any API to configure the API method, endpoint URL, date/time and lookup macros, path to data, metadata, and request headers.

The Adjust Report Service API is read-only, so reporting calls use the GET method. The base URL is https://automate.adjust.com/reports-service; for example, a JSON report request is https://automate.adjust.com/reports-service/report?dimensions=app,day&metrics=installs,sessions&date_period=-30d:-1d. For the JSON report endpoint, use $.rows[*] as the path to data to extract each row from the rows array; for the events endpoint, use $[*] to extract each element from the root-level array. The report row schema is dynamic and depends on the dimensions and metrics in your request, so the columns of the extracted records will vary with your configuration—ensure the JSONPath expression matches the structure returned by your specific endpoint. The Authorization: Bearer header is applied automatically from your saved credential, so you do not need to add it as a request header.

The Adjust Report Service API enforces a rate limit of 50 requests per second per source IP (with a burst allowance of 100). For large extracts, partition pulls by date period rather than issuing many concurrent requests, and consider the Parquet report endpoint for very large reports.

Once all of the relevant settings have been configured, click the Create button in the upper right corner of the screen to save and create the new Adjust data source. Nexla will now begin ingesting data from the configured endpoint and will organize any data that it finds into one or more Nexsets.