> ## 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 RTB House data source to Adriel: enter API credentials, select advertisers, and import retargeting performance and conversion data.

RTB House is a deep-learning-based personalized retargeting and performance display platform. Connecting it ingests campaign performance and conversion attribution data from the RTB House REST API, scoped per advertiser, and standardizes spend, impressions, clicks, conversions, and derived rates for cross-channel reporting.

## Before you connect

The following are required:

* An RTB House account with API access enabled.
* An RTB House API User ID and password issued by the RTB House account team. Credentials are provisioned by the RTB House account manager; contact RTB House support when API access is not already available.
* Permission on the advertisers whose data should be imported.

## Connect RTB House

<Steps>
  <Step title="Obtain RTB House credentials">
    Contact the RTB House account manager and request an API **User ID** and **password**. These are used in place of an OAuth sign-in.
  </Step>

  <Step title="Select RTB House">
    On the **Data Sources** page, search for **RTB House** and select it.
  </Step>

  <Step title="Enter the credentials">
    Paste the API **User ID** and **password** into the corresponding fields. Credentials are sent with every API call; no OAuth flow is involved.
  </Step>

  <Step title="Choose the advertisers">
    When the credentials grant access to multiple advertisers, select one or more. A separate data source is created per advertiser.
  </Step>

  <Step title="Save the data source">
    Click **Save** to complete the connection. The initial backfill begins on save and includes both the basic performance and conversion attribution passes.
  </Step>
</Steps>

## What gets imported

Performance data is imported at advertiser, campaign, ad set, and ad levels, with breakdowns by conversion attribution model and day. Standard metrics include spend, impressions, clicks, conversions, and conversion value, plus derived rates such as CTR, CPC, CPM, and ROAS. Architecture refreshes twice daily, and report data is available in real time with scheduled syncs over rolling 3-, 9-, and 30-day windows.

For the complete list of metrics, breakdowns, refresh cadence, and date range limits, see the [RTB House data reference](/data-sources/o-z/rtb-house/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication fails after a successful initial connection">
    RTB House credentials do not auto-rotate, but they can be revoked or reset by the RTB House account team. A connection that suddenly fails authentication usually indicates rotated or revoked credentials. Reconnect with refreshed credentials issued by RTB House.
  </Accordion>

  <Accordion title="Some advertisers are missing from the picker">
    Only advertisers visible to the API User are returned. Confirm with the RTB House account manager that the API User has access to each advertiser that should appear.
  </Accordion>

  <Accordion title="Spend or conversion value does not match the workspace display currency">
    Values are reported in the advertiser's billing currency. Workspaces using a different display currency receive auto-converted values.
  </Accordion>

  <Accordion title="Conversion totals appear duplicated across attribution rows">
    Reports include multiple attribution model variants side by side. Filter by a single attribution type when comparing totals to RTB House's own panel views.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="RTB House data reference" href="/data-sources/o-z/rtb-house/data-reference">
    Metrics, breakdowns, refresh cadence, and limits for RTB House.
  </Card>

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

  <Card title="How to connect Criteo" href="/data-sources/a-f/criteo/how-to-connect">
    Connect another retargeting and performance display platform.
  </Card>
</CardGroup>
