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

Snapchat Ads is Snap Inc.'s paid advertising platform, delivering single-image, video, story, collection, and AR-lens ads across the Snapchat app, Discover, and Spotlight. Connecting it brings the full campaign hierarchy, performance and engagement metrics, reach and frequency, and Snap Pixel and SKAdNetwork conversion events into Adriel dashboards alongside other marketing sources.

## Before you connect

The following are required:

* A Snap Ads Manager account with admin or operator-level access on the target ad account.
* Authorization to grant the `snapchat-marketing-api` scope on sign-in.
* An active Snap Pixel deployed on destination pages, if conversion tracking is expected.

## Connect Snapchat

<Steps>
  <Step title="Authorize a Snapchat account">
    On the **Data Sources** page, search for **Snapchat** and select it. Sign in to Snapchat in the pop-up window using an account with access to the target ad accounts, then click **Continue** to grant access.
  </Step>

  <Step title="Select the ad accounts">
    On the data source settings, choose the **Ad accounts** to connect.
  </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

The connector imports the full campaign hierarchy (organization → ad account → campaign → ad squad → ad → creative), standard performance metrics (impressions, swipes, CTR, frequency, reach, spend), video and story engagement (video views, quartile completions, average view time, story opens and completes), and all Snap Pixel conversion events configured on the account, including revenue. Ad-account-level breakdowns include age, location, gender, device target, country, DMA region, OS, and device make.

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

## Troubleshooting

<AccordionGroup>
  <Accordion title="Subscribe metric is missing when a breakdown is added">
    The Snapchat Marketing API does not support the Subscribe conversion metric together with segmentation, so it is silently excluded when any breakdown is applied. Remove the breakdown to view Subscribe data, or select an alternative conversion metric.
  </Accordion>

  <Accordion title="Revenue values show as zero">
    Snap Pixel events must include a value parameter for revenue to populate. Events firing without an associated value produce conversion counts but no revenue. Verify the Pixel implementation in Snapchat Events Manager.
  </Accordion>

  <Accordion title="Reach or frequency numbers look inflated across multi-day ranges">
    Reach-style metrics are computed per daily snapshot. When viewed across a multi-day range, the same user can be counted on each day they were reached, which can overstate the total. This is an inherent tradeoff of cached daily reporting.
  </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. Open **Connections > Snapchat** and click **Reconnect**.
  </Accordion>
</AccordionGroup>

## Related

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

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

  <Card title="How to connect TikTok" href="/data-sources/o-z/tiktok/how-to-connect">
    Connect TikTok paid advertising performance.
  </Card>

  <Card title="How to connect Reddit" href="/data-sources/o-z/reddit/how-to-connect">
    Connect Reddit paid advertising performance.
  </Card>
</CardGroup>