Skip to main content

​
Introduction

Yahoo Ads is Yahoo’s US and global advertising platform, delivering search, native, and display ads across Yahoo properties (Yahoo Mail, Yahoo Finance, Yahoo News, AOL) and partner publishers through the Gemini ad network. It is used by marketers reaching audiences outside the Google and Meta ecosystems, with CPC and CPM payment models across awareness, traffic, and conversion objectives. The connector authenticates with Yahoo’s OAuth 2.0 flow and imports architecture and performance data through the Adriel backend rather than calling the Gemini API directly. As a marketing connector, metrics, breakdowns, and currencies are standardized so widgets can aggregate across sources without additional configuration.
Yahoo Ads vs Yahoo Japan vs Yahoo DSPThree separate connector families share the Yahoo name. Yahoo Ads (this connector) covers Yahoo’s US/global Gemini network. Yahoo Japan Search Ads and Yahoo Japan Display Ads cover the Japanese market with different APIs and breakdowns. Yahoo DSP covers programmatic display, video, native, CTV, and DOOH inventory through a different authentication flow.
To connect this data source, see How to connect Yahoo Ads to Adriel.

​
Data refresh strategy

​
Architecture data

Architecture covers ad accounts, campaigns, ad sets (ad groups), ads, and keywords. It refreshes twice daily at 4:00 PM UTC and 5:00 AM UTC.

​
Reports data

Reports include daily performance for ad accounts, campaigns, ad sets, and ads. Real-time. Report data is fetched from the Gemini network on demand when a dashboard loads, so the latest values are always visible. On top of that, scheduled cache refreshes backfill late-arriving conversion and click data across several time windows. Refresh schedule. Reports refresh on three overlapping schedules:
  • 5:00 PM UTC daily — syncs the last 9 days for ad account, campaign, ad set, and ad
  • 11:40 PM and 6:40 AM UTC daily — syncs the last 3 days for ad account, campaign, ad set, and ad
  • 7:30 AM UTC on the 1st and 15th of each month — syncs the last 30 days for ad account, campaign, ad set, and ad

​
Architecture levels

Ad account → Campaign → Ad set (ad group) → Ad → Keyword Reports can be grouped at the campaign, ad set, ad, and keyword levels. The ad account level is used for architecture and account-wide totals but is not available as a report breakdown level.

​
Date range limits

To keep query sizes manageable, the connector enforces these maximum look-back windows:

​
Metrics

How to read the columnsThe Data type column shows how each value is formatted. In the API Key column, code style like spend is the literal Gemini reporting field, while italic text describes how a value is produced when it does not map to a single source field (for example Adriel-computed rates).

​
Reach & impressions

​
Click performance

​
Cost & spend

Currency conversionEach ad account’s currency is inherited from its Yahoo Ads settings. When an ad account’s currency differs from the workspace currency, costs are automatically converted using the current day’s exchange rate.

​
Conversion performance

​
Breakdowns

​
Standard hierarchy

​
Demographics

​
Geographic

​
Device

​
Time & date grouping

Yahoo returns daily records; Adriel groups them into these views for reporting.

​
Limitations

Based on the current connector, Yahoo Ads has the following limits:
  • Date-range caps — daily breakdowns are limited to 93 days, weekly to 1 year, and monthly to 2 years. Data outside a selected breakdown’s window may be truncated.
  • No ad-account-level breakdown — reports can be grouped at the campaign, ad set, ad, and keyword levels only. The ad account level is not available as a report breakdown.
  • Search-only keyword data — the Keyword breakdown returns data for search campaigns only.
  • Separate Yahoo connectors — Yahoo Japan (Search and Display) and Yahoo DSP are distinct connectors with their own APIs, breakdowns, and refresh schedules. Data does not carry over between them.

​
API references

​
See also

  • Yahoo Ads how-to (paired) — step-by-step setup guide
  • Yahoo DSP data reference — for programmatic display, video, native, CTV, and DOOH
  • Yahoo Japan Search Ads data reference — for Japan-specific search advertising
  • Yahoo Japan Display Ads data reference — for Japan-specific display advertising