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

Pinterest Ads is Pinterest's paid advertising platform, spanning promoted pins, shopping ads, and video ads across awareness, consideration, conversion, and catalog-sales objectives. Connecting it brings the full campaign hierarchy, standard performance and video metrics, and Pinterest-specific engagement and conversion events tracked through the Pinterest Tag into Adriel dashboards alongside other marketing sources.

## Before you connect

The following are required:

* A Pinterest Ads (Business) account with admin access on the target ad account.
* An active Pinterest Tag deployed on destination pages, if conversion tracking is expected.
* Authorization to grant read access on the Pinterest ad account during sign-in.

## Connect Pinterest Ads

<Steps>
  <Step title="Authorize a Pinterest account">
    On the **Data Sources** page, search for **Pinterest Ads** and select it. Sign in to Pinterest in the pop-up window using an account with access to the target ad accounts, then approve read access on the requested permissions screen.
  </Step>

  <Step title="Select ad accounts and attribution windows">
    On the data source settings, choose the **Ad Accounts** to connect, then set the report attribution windows. Only the following 15 combinations are supported:

    | Report Attribution Windows : Click Days | Report Attribution Windows : Engagement Days | Report Attribution Windows : View Days |
    | --------------------------------------- | -------------------------------------------- | -------------------------------------- |
    | 1                                       | 0                                            | 0                                      |
    | 1                                       | 1                                            | 1                                      |
    | 7                                       | 0                                            | 0                                      |
    | 7                                       | 1                                            | 1                                      |
    | 7                                       | 7                                            | 1                                      |
    | 7                                       | 7                                            | 7                                      |
    | 30                                      | 1                                            | 1                                      |
    | 30                                      | 1                                            | 30                                     |
    | 30                                      | 30                                           | 1                                      |
    | 30                                      | 30                                           | 7                                      |
    | 30                                      | 30                                           | 30                                     |
    | 60                                      | 60                                           | 1                                      |
    | 60                                      | 60                                           | 7                                      |
    | 60                                      | 60                                           | 30                                     |
    | 60                                      | 60                                           | 60                                     |
  </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 (ad account → campaign → ad group → ad), standard performance metrics (impressions, clicks, CTR, CPC, spend, saves, outbound clicks), video views and 25/50/75/100% completions, and conversion events tracked through the Pinterest Tag, including revenue. Breakdowns for age, gender, location, OS/device, country, audience, platform placement, and search term are available at ad-account scope.

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

## Troubleshooting

<AccordionGroup>
  <Accordion title="Revenue shows 0 even though purchases exist in Pinterest">
    Revenue values are received from Pinterest in microdollars and converted automatically. A 0 value usually indicates the `value` parameter on the Pinterest Tag's purchase event is missing or unset. The tag implementation should pass a numeric value on purchase.
  </Accordion>

  <Accordion title="Recent data appears delayed">
    Pinterest Ads is a cache-only connector; report data is served from the most recent scheduled snapshot rather than fetched live. The last few hours may not appear until the next refresh window completes.
  </Accordion>

  <Accordion title="Conversion events are missing">
    Conversion events configured on the Pinterest ad account are imported automatically, but only currently active events surface in dashboards. Paused or deleted events do not appear.
  </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 > Pinterest Ads** and click **Reconnect**.
  </Accordion>
</AccordionGroup>

## Related

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

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

  <Card title="How to connect Pinterest Organic" href="/data-sources/o-z/pinterest-organic/how-to-connect">
    Connect owned Pinterest account and pin analytics.
  </Card>
</CardGroup>