> ## 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 Yahoo! DSP data source to Adriel: gather API credentials, enter them, and select advertisers.

Yahoo! DSP is Yahoo's demand-side platform for programmatic advertising across display, video, native, connected TV (CTV), and digital out-of-home (DOOH) on Yahoo's network and third-party publishers. Connecting it brings the full campaign hierarchy and Yahoo! DSP's broad measurement surface — performance, viewability, video completion, brand safety, audience reach, and fee breakdowns — into Adriel dashboards alongside other marketing sources.

<Info>
  Yahoo! DSP covers programmatic buying across display, video, native, CTV, and DOOH. For Yahoo's standard search and display through the advertiser interface, use the separate **Yahoo! Ads** connector.
</Info>

## Before you connect

The following are required:

* A Yahoo! DSP account with admin or operator-level access.
* A **Client ID** and **Client Secret** issued by Yahoo! DSP for API access. To generate them, log in to the Yahoo! DSP account, follow Yahoo's [setup access guide](https://help.yahooinc.com/dsp-api/docs/setup-access-guide#get-your-client-id-and-client-secret), open **My Account** from the profile menu, then select **Activate** and click **Agree**. Copy and store both values — lost credentials cannot be recovered and must be regenerated.
* **Seat Access** on the Yahoo! DSP account for Yahoo Native (Mail Ad) metrics. Either Seat or GAN access is required for DOOH-specific metrics.

## Connect Yahoo! DSP

<Steps>
  <Step title="Select the data source">
    On the **Data Sources** page, search for **Yahoo! DSP** and select it.
  </Step>

  <Step title="Enter the credentials">
    Fill in the three required fields, then click **Submit**. Enter any identifiable **Name**, the **Client ID** retrieved earlier, and the **Client Secret** retrieved earlier.
  </Step>

  <Step title="Select the advertisers">
    Choose the **Advertiser** to connect from the dropdown. Select multiple advertisers if needed.
  </Step>

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

## What gets imported

The connector imports data at every level of the campaign hierarchy — ad account, campaign, ad set (line item), and ad (creative). Performance metrics arrive alongside viewability metrics (Moat, GroupM, Yahoo viewability), video completion metrics (25/50/75/100%, CPCV, drop rates), brand safety and ad verification costs, audience and reach metrics (unique households, average frequency), Yahoo Native (Mail Ad) metrics where Seat Access is granted, DOOH-specific metrics, and fee breakdowns.

For the complete list of metrics, breakdowns, and refresh cadence, see the [Yahoo! DSP data reference](/data-sources/o-z/yahoo-dsp/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Viewability metrics appear partial">
    Viewability metrics depend on the third-party verification provider configured on the Yahoo! DSP campaign. Moat and Yahoo native viewability metrics surface in the connector; campaigns using GroupM only populate the GroupM viewability metric set.
  </Accordion>

  <Accordion title="Yahoo Native (Mail Ad) metrics are missing">
    Mail Ad metrics require Seat Access on the Yahoo! DSP account. GAN-only access does not expose these metrics.
  </Accordion>

  <Accordion title="Tile Impressions or Tile Click Outs are empty">
    These two metrics are intentionally excluded from API requests and never populate.
  </Accordion>

  <Accordion title="Authentication errors after credential rotation">
    Access tokens are minted on demand from the stored Client ID and Client Secret, so there is no user-facing token expiry. If Yahoo! DSP regenerates the Client Secret, update the stored credentials in **Connections > Yahoo! DSP**.
  </Accordion>
</AccordionGroup>

## Related

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

  <Card title="Yahoo! DSP FAQs" href="/data-sources/o-z/yahoo-dsp/faqs">
    Common questions and expected behaviors for the Yahoo! DSP data source.
  </Card>

  <Card title="How to connect Yahoo! Ads" href="/data-sources/o-z/yahoo-ads/how-to-connect">
    Connect Yahoo's search and display advertiser interface.
  </Card>

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