> ## Documentation Index
> Fetch the complete documentation index at: https://docs.adriel.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect

> How to connect the etracker data source to Adriel: enter an access token, choose a report, and import its analytics data.

etracker is a German web-analytics platform built around GDPR-compliant, cookieless tracking for European audiences. Connecting it brings visits, visitors, page views, sessions, and conversion events into Adriel dashboards, with the available metrics and breakdowns determined by the etracker report that each data source is bound to.

## Before you connect

The following are required:

* An active etracker account with API access enabled.
* Administrator (main user) permission to generate or retrieve the API access token under **Settings → Account → Integration** in etracker.
* An etracker API access token. Log in to etracker, go to **Settings → Account → Integration**, create or retrieve the Access Token, and copy it for the connection flow.
* The etracker report whose data should be imported. Each data source binds to a single report.

## Connect etracker

<Steps>
  <Step title="Select the data source">
    On the **Data Sources** page, search for **etracker** and select it.
  </Step>

  <Step title="Enter the access token">
    Under **Connection Settings**, enter the Access Token copied from etracker and click **Submit**.
  </Step>

  <Step title="Choose the report">
    Under **Data Source Settings**, set the required and optional fields:

    * **\[Required] Report ID**: Select one or more reports to connect. Each report binds its own column list of available metrics and breakdowns.
    * **\[Optional] Name**: Enter an identifiable name for the data source. This helps distinguish multiple etracker data sources.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day. Day, week, and month breakdowns appear when the selected report includes the `utm_date` column.
  </Step>
</Steps>

## What gets imported

The connector imports the rows returned by the selected etracker report, with metrics and breakdowns driven by that report's column list. Standard analytics fields — visits, unique visitors, page views, bounce rate, average time on site, conversions, revenue, and order count — appear when the report exposes them. Day, week, and month breakdowns are available for reports that include the `utm_date` column.

For the complete field list, see the [etracker data reference](/data-sources/a-f/etracker/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Date breakdowns are missing for a report">
    Day, week, and month groupings appear only when the selected report's metadata includes a column with `id` equal to `utm_date`. Reports that lack that column return aggregate rows only. Adjust the report inside etracker to include the date column, or pick a different report.
  </Accordion>

  <Accordion title="A different report is needed">
    Each data source binds to a single report. Add a new data source for each additional report rather than swapping reports inside an existing connection.
  </Accordion>

  <Accordion title="Requests start failing after token rotation">
    The access token is long-lived and stored at connection setup. Rotating or revoking the token inside etracker invalidates every subsequent request. Re-save the connection with the new token to restore reporting.
  </Accordion>

  <Accordion title="A metric or breakdown is missing from the field picker">
    Available fields reflect the columns the selected report declares in its metadata. Add the missing column to the etracker report definition and re-save the data source so the metadata is refetched.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="etracker data reference" href="/data-sources/a-f/etracker/data-reference">
    Metrics, breakdowns, and limits for etracker.
  </Card>

  <Card title="etracker FAQs" href="/data-sources/a-f/etracker/faqs">
    Common questions and expected behaviors for the etracker data source.
  </Card>

  <Card title="How to connect Matomo" href="/data-sources/g-n/matomo/how-to-connect">
    Connect an alternative privacy-focused web-analytics platform.
  </Card>

  <Card title="How to connect Piano Analytics" href="/data-sources/o-z/piano-analytics/how-to-connect">
    Connect another European-focused web-analytics platform.
  </Card>
</CardGroup>