> ## 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 Amazon DSP data source to Adriel: authorize a Login with Amazon account, select a profile and advertiser, and import programmatic performance.

Amazon DSP is Amazon's demand-side platform for programmatic display, video, audio, and over-the-top advertising across Amazon-owned properties such as IMDb, Twitch, and Fire TV, as well as third-party publishers. Connecting it brings the DSP advertiser, order, line-item, and creative hierarchy into Adriel dashboards alongside performance, viewability, video, and conversion metrics.

## Before you connect

The following are required:

* An Amazon DSP account with admin access.
* An Amazon login (Login with Amazon) with permission to manage the DSP advertiser. The authorization grants the `cpc_advertising:campaign_management` scope.

Amazon DSP is distinct from Amazon Ads, which covers Sponsored Products, Sponsored Brands, and Sponsored Display on Amazon's retail surface. The same Login with Amazon credentials cover both.

## Connect Amazon DSP

<Steps>
  <Step title="Authorize the Amazon account">
    On the **Data Sources** page, search for **Amazon DSP** and select it. Sign in with Login with Amazon in the pop-up window, then click **Allow** to grant access. Amazon requests the `cpc_advertising:campaign_management` scope.
  </Step>

  <Step title="Select the profile and advertiser">
    On the data source settings, choose the two mandatory fields for the account to connect. Set **Profile** to the Amazon DSP account profile — the region (NA, EU, or FE) is auto-detected from the authenticated profile. Set **Advertiser** to the linked DSP advertiser under that profile.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day. The cache backfills with 89 days of historical data at the advertiser, campaign, ad set, and ad levels.
  </Step>
</Steps>

## What gets imported

The connector imports the full DSP hierarchy from advertiser to order to line item to creative, with performance metrics (impressions, click-throughs, eCPM, eCPC, eCPA, total cost, supply cost), viewability metrics including per-vendor data from DoubleVerify, IAS, ComScore, and DoubleClick, video quartile metrics, and conversion metrics on Amazon's fixed 14-day attribution window. Breakdowns include creative title, deal type, supply source, creative size, browser, and operating system.

For the complete list of metrics, breakdowns, and attribution logic, see the [Amazon DSP data reference](/data-sources/a-f/amazon-dsp/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Conversion numbers differ from platforms with other attribution windows">
    Amazon DSP enforces a 14-day attribution window across all conversion metrics, surfaced with a `14d` suffix. Shorter or longer windows are not supported by the DSP API. Differences against platforms with other defaults (for example, a 7-day click window) reflect this attribution mismatch.
  </Accordion>

  <Accordion title="Conversion figures change retroactively">
    When ASINs are added to or removed from a campaign after it starts, Amazon restates conversion attribution using the current ASIN set. Restatements apply retroactively and settle within 28 days, so older periods can change between refreshes.
  </Accordion>

  <Accordion title="ROAS metrics are not shown as Amazon-native fields">
    Amazon DSP does not expose ROAS variants as API fields. They are computed downstream from underlying spend and conversion-value data. Combined and new-to-brand ROAS variants appear as derived metrics.
  </Accordion>

  <Accordion title="Recent activity is not yet reflected">
    Reports are cache-only and refresh once daily for the last 7 days. The most recent hours of activity are not fetched live on dashboard load.
  </Accordion>

  <Accordion title="Authentication failed and cannot refresh">
    Re-establish the connection from **Connections > Amazon DSP > Reconnect**. The same Login with Amazon credentials cover both Amazon DSP and Amazon Ads.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Amazon DSP data reference" href="/data-sources/a-f/amazon-dsp/data-reference">
    Metrics, breakdowns, attribution windows, and limits for Amazon DSP.
  </Card>

  <Card title="Amazon DSP FAQs" href="/data-sources/a-f/amazon-dsp/faqs">
    Common questions and expected behaviors for the Amazon DSP data source.
  </Card>

  <Card title="How to connect Amazon Ads" href="/data-sources/a-f/amazon-ads/how-to-connect">
    Connect Sponsored Products, Brands, and Display on Amazon's retail surface.
  </Card>

  <Card title="How to connect The Trade Desk" href="/data-sources/o-z/the-trade-desk/how-to-connect">
    Connect a comparable programmatic demand-side platform.
  </Card>
</CardGroup>