> ## 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 Singular data source to Adriel: add a Singular API key, choose a report type, and import daily mobile attribution data.

Singular is a mobile measurement partner (MMP) that consolidates attribution, marketing data, and SKAdNetwork postbacks across mobile ad networks. Connecting it brings per-day campaign performance, in-app event tracking, and SKAdNetwork data into Adriel dashboards through the Singular Reporting API.

Each data source maps to one app and one report type. **SKAN** covers Apple's privacy-preserving SKAdNetwork attribution, while the standard cross-network report type covers unified attribution. To pull more than one report type, create a separate data source for each.

## Before you connect

The following are required:

* A Singular account with API access.
* A **Singular API key**, generated from the Singular dashboard under **Developer Tools** → **API Keys**. Singular's *Reporting API Reference* documentation provides additional context.
* A report-type decision for each data source, since the report type is set per data source at creation.

## Connect Singular

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

  <Step title="Enter the API key">
    Paste the **API Key** retrieved from the Singular dashboard into the **API Key** field.
  </Step>

  <Step title="Choose the report type and options">
    Enter a **Name** to identify the data source, then choose the **Report Type** — **All**, **SKAN**, or **Normal**. Optionally, refine the pull under **Configuration**: filters (**Campaign Filter**, **App Filter**, **Country Filter**, **Custom Filter**), metric selectors (**Cohort Metrics**, **SKAN Events**, **Conversion Metrics**), and extra breakdown options. Apply a filter only when the same filter is in use in the Singular UI.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

Reports arrive at daily granularity in each ad network's local currency. After connection, the previous 60 days are backfilled; afterward, the most recent 30 days are refreshed daily. SKAdNetwork installs and conversion values follow Apple's postback timer, so the most recent days settle as later postbacks land.

For the full metric list and SKAN and unified report details, see the [Singular data reference](/data-sources/o-z/singular/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="The API key is rejected">
    Singular validates the key against its cohort metrics endpoint, and a non-200 response causes the key to be treated as invalid. Regenerate the key under **Developer Tools** → **API Keys** in Singular and reconnect.
  </Accordion>

  <Accordion title="Validation error: at least one metric or SKAN event must be selected">
    SKAN report types require at least one standard SKAN metric or SKAN event. Re-open the data source form and add a selection from either picker.
  </Accordion>

  <Accordion title="Validation error: at least one metric, cohort, or conversion metric must be selected">
    Unified report types require at least one standard metric, cohort metric, or conversion metric. Add a selection from at least one of the three pickers.
  </Accordion>

  <Accordion title="SKAN and unified data are needed together">
    A single data source supports one report type. Create a second Singular data source in the other report type to pull both alongside each other.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Singular data reference" href="/data-sources/o-z/singular/data-reference">
    Metrics, breakdowns, report types, and limits for Singular.
  </Card>

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

  <Card title="How to connect AppsFlyer" href="/data-sources/a-f/appsflyer/how-to-connect">
    Connect another mobile measurement partner with similar coverage.
  </Card>

  <Card title="How to connect Adjust" href="/data-sources/a-f/adjust/how-to-connect">
    Connect the Adjust MMP data source.
  </Card>
</CardGroup>