> ## 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 Reddit data source to Adriel: authorize a Reddit account, select a Business and ad account, and verify data.

Reddit Ads is Reddit's paid advertising platform, running promoted posts, video ads, and conversation placements across interest-based communities. Connecting it brings the full campaign hierarchy, standard performance and video metrics, and Reddit Pixel conversion events into Adriel dashboards alongside other marketing sources.

## Before you connect

The following are required:

* A Reddit account with admin access on the target Reddit Business or Ads account.
* A **Business ID** assigned to the ad account. Reddit accounts created before the Business ID requirement must be migrated by Reddit support before they can be connected.
* An active Reddit Pixel deployed on destination pages, if conversion tracking is expected.
* Authorization to grant read access on the Reddit Marketing API during sign-in.

## Connect Reddit

<Steps>
  <Step title="Authorize a Reddit account">
    On the **Data Sources** page, search for **Reddit** and select it. Sign in to Reddit in the pop-up using an account with access to the target Business or Ads account, then click **Allow** to grant Reddit Marketing API read access.
  </Step>

  <Step title="Select the Business and ad account">
    On the data source settings, choose the **Business** to connect from the drop-down, then choose the **Ad Account** to connect. The account ID can be confirmed at [ads.reddit.com/accounts](https://ads.reddit.com/accounts).
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. The initial backfill runs in the background and typically completes within one business day.
  </Step>
</Steps>

## What gets imported

The connector imports the full campaign hierarchy (ad account, campaign, ad group, and ad), standard performance metrics (impressions, clicks, CTR, eCPC, eCPM, spend), video metrics (starts, completions, and quartile and time-based milestones), and Reddit Pixel conversion events including revenue. Ad-account-level breakdowns include country, region, OS, platform placement, and gender.

For the complete list of metrics, breakdowns, and refresh cadence, see the [Reddit Ads data reference](/data-sources/o-z/reddit/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Data source creation fails with INVALID_DATA_SOURCE">
    Legacy Reddit Ads accounts created before the Business ID requirement do not have an associated Business ID and cannot be connected. Contact Reddit support to add a Business ID to the account, then create the data source again.
  </Accordion>

  <Accordion title="Dates appear shifted in dashboards">
    Reddit returns timestamps in the ad account's local timezone, and they are normalized to the workspace timezone during ingestion. Apparent date shifts usually indicate a mismatched workspace timezone setting; verify it matches the intended reporting timezone.
  </Accordion>

  <Accordion title="Refresh appears slow on Businesses with many ad accounts">
    The Reddit Marketing API enforces a rate limit of one call per 12 seconds per ad account. Businesses with many sub-accounts may take longer to refresh fully. Rate-limit errors resolve automatically on subsequent refresh windows.
  </Accordion>

  <Accordion title="App-install or SKAdNetwork metrics are not visible">
    App-install and SKAdNetwork metrics are not currently exposed by the connector. The available metrics are the performance, video, and Reddit Pixel conversion metrics listed in the data reference.
  </Accordion>

  <Accordion title="Authentication errors">
    Access tokens are renewed automatically from the stored refresh token. Persistent authentication errors usually indicate a revoked or expired refresh token. Reconnect via Connections → Reddit Ads → Reconnect and sign in again.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Reddit Ads data reference" href="/data-sources/o-z/reddit/data-reference">
    Metrics, breakdowns, and refresh cadence for Reddit Ads.
  </Card>

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

  <Card title="How to connect Reddit Public" href="/data-sources/o-z/reddit-public/how-to-connect">
    Connect public Reddit community and post metrics.
  </Card>
</CardGroup>