> ## 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 Simpli.fi data source to Adriel: gather App Key, User Key, and Organization ID, then choose a report mode.

Simpli.fi is a programmatic advertising platform specializing in addressable, geo-fence, and site-list campaigns across display, video, CTV, and audio inventory. Connecting it imports campaign performance from a Simpli.fi organization through the Simpli.fi REST API, surfacing impressions, clicks, spend, conversions, and audience reach alongside other platforms in cross-channel dashboards.

## Before you connect

The following are required:

* A Simpli.fi account with API access enabled. API access is provisioned through the Simpli.fi account team.
* The Simpli.fi **App Key** and **User Key** (User API Key).
* The numeric Simpli.fi **Organization ID** for the account.
* For Custom Reports mode, a Simpli.fi Custom Report defined in advance with the desired columns.

## Connect Simpli.fi

<Steps>
  <Step title="Request Simpli.fi credentials">
    Contact the Simpli.fi account manager to enable API access. Obtain the **App Key**, the **User Key** (User API Key), and the numeric **Organization ID** for the account.
  </Step>

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

  <Step title="Enter credentials">
    Enter the three required credential fields gathered earlier, then click **Submit**.

    * **App Key**
    * **User Key** (User API Key)
    * **Organization ID**
  </Step>

  <Step title="Configure the report">
    Complete the report fields, then click **Submit**.

    * **Name**: Any readable, identifiable name. Distinguishes each data source.
    * **Report Type**: Select the type from the drop-down list. Campaign Stats and Custom Reports are supported.
    * **Detailed Report Type**: Select one type from the drop-down list, for example **Account Conversion by Ad**.
    * **Filter Column** (optional): One column to filter by.
    * **Filter Value** (optional): One value to filter on. Use accurate capitalization for best results.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Each detailed report type corresponds to one data source; to connect multiple report types, repeat the report configuration for each. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

Campaign-level performance — impressions, clicks, spend, conversions, video quartiles, viewability, and geo-fence visits — imports at daily granularity across the organization, ad account, campaign, ad group, and ad hierarchy. In Custom Reports mode, the connector imports whatever metrics and breakdowns the underlying report defines.

For the complete field list, see the [Simpli.fi data reference](/data-sources/o-z/simplifi/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Report mode cannot be changed after creation">
    Campaign Stats and Custom Reports are mutually exclusive and fixed at creation. Switching modes requires creating a new data source.
  </Accordion>

  <Accordion title="History older than 60 days is missing after first connect">
    The initial backfill loads only the last 60 days. Older history requires Simpli.fi-side exports and is not retrieved by the connector.
  </Accordion>

  <Accordion title="Late-attributed conversions outside 30 days are not refreshed">
    The daily refresh rewrites only the most recent 30 days. Restatements or late conversions outside that window will not appear without a manual rebuild.
  </Accordion>

  <Accordion title="Video or geo-fence metrics return empty">
    These metrics populate only when the campaign type supports them. Display-only campaigns leave video and geo-fence columns empty.
  </Accordion>

  <Accordion title="Requests fail immediately after key rotation">
    The App Key and User Key never expire automatically. When keys are revoked or rotated in Simpli.fi, requests fail until the connection is re-saved with the replacement values.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Simpli.fi data reference" href="/data-sources/o-z/simplifi/data-reference">
    Metrics, breakdowns, and limits for Simpli.fi.
  </Card>

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

  <Card title="How to connect The Trade Desk" href="/data-sources/o-z/the-trade-desk/how-to-connect">
    Connect another programmatic DSP with a comparable campaign hierarchy.
  </Card>

  <Card title="How to connect StackAdapt" href="/data-sources/o-z/stackadapt/how-to-connect">
    Connect a programmatic platform with similar report-mode separation.
  </Card>
</CardGroup>