> ## 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 Piano Analytics data source to Adriel: gather API keys and a Site ID, authorize the connection, and select a site.

Piano Analytics is a European web and content analytics platform, formerly known as AT Internet and rebranded under the Piano family. Connecting it brings visits, unique visitors, page views, engagement, goal completions, and source-attribution data into Adriel dashboards, scoped per tracked site.

## Before you connect

The following are required:

* An active Piano Analytics account with dashboard access.
* Piano Analytics API keys (an **Access Key** and a **Secret Key**). To generate them, sign in to Piano Analytics, open the profile menu in the top-right corner and select **See profile**, open the **API Keys** tab, click **Create a new API Key**, and enter a name and description. Save both keys securely — the **Access Key** and **Secret Key** are shown only once at generation.
* A Piano Analytics **Site ID** for each site to connect. To retrieve it, go to **Configuration** > **Data Collection Portal** > **Dashboard** and copy the value from the **ID** column.

## Connect Piano Analytics

<Steps>
  <Step title="Authorize with the API keys">
    On the **Data Sources** page, search for **Piano Analytics** and select it. Enter the **Access Key** and **Secret Key** prepared in the prerequisites, then click **Submit**. Credentials are validated when the connection is saved.
  </Step>

  <Step title="Select the site">
    Enter the **Site ID** copied from **Configuration** > **Data Collection Portal** > **Dashboard**, and a **Name** to identify the data source. To connect multiple sites, repeat this step for each Site ID.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Reports are fetched live on each dashboard load, so data appears as soon as the site is connected.
  </Step>
</Steps>

## What gets imported

The connector imports traffic and engagement metrics (visits, unique visitors, page views, bounce rate, time spent), goal completions and event counts, revenue and transaction values, and breakdowns covering source attribution, page hierarchy, device, and geography. Metrics and breakdowns come from a fixed catalog; custom indicators defined inside a Piano Analytics workspace are not currently exposed as additional fields.

For the complete list of metrics, breakdowns, refresh cadence, and limits, see the [Piano Analytics data reference](/data-sources/o-z/piano-analytics/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="A 'too much data requested' error appears">
    A single Data API request accepts at most 50 columns (metrics and breakdowns combined). Reduce the number of selected fields or split the report across multiple widgets.
  </Accordion>

  <Accordion title="Reports stop returning rows beyond a certain point">
    The Data API caps results at 10,000 rows per page and 200,000 rows in total per query. Apply narrower filters or higher-level aggregations to inspect data beyond that ceiling.
  </Accordion>

  <Accordion title="Custom indicators defined in Piano Analytics are missing">
    The connector exposes a fixed catalog of metrics and breakdown properties. Custom indicators created inside a Piano Analytics workspace are not currently surfaced as additional fields.
  </Accordion>

  <Accordion title="Credentials appear valid but reports fail">
    The credential check runs at save time, so permission or key issues that develop later surface only when the next report query fails. Re-saving the connection forces a fresh credential check.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Piano Analytics data reference" href="/data-sources/o-z/piano-analytics/data-reference">
    Metrics, breakdowns, refresh cadence, and limits for Piano Analytics.
  </Card>

  <Card title="Piano Analytics FAQs" href="/data-sources/o-z/piano-analytics/faqs">
    Common questions and expected behaviors for the Piano Analytics data source.
  </Card>

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

  <Card title="How to connect Google Analytics 4" href="/data-sources/g-n/google-analytics-4/how-to-connect">
    Connect event-based web and app analytics.
  </Card>
</CardGroup>