Historical data limitations by connector#
This page summarizes how far back you can fetch data for each connector, and any per-request date range limits that affect backfills and initial data loads. Limits are imposed by the underlying platform APIs and cannot be changed in Adverity.
For setup instructions and full limitations for a specific connector, see the individual connector guides.
Connector |
Historical data available |
Notes |
|---|---|---|
Up to 397 days |
Maximum 10 metrics per datastream |
|
Up to 60 days (95 days for Sponsored Television reports) |
Date range and lookback window limits are enforced per report type; fetching outside the allowed range displays a validation error |
|
Most recent 13 months (event-level data) |
— |
|
Varies by report type |
See Amazon Selling Partner below |
|
Varies by granularity |
See Apple Search Ads below |
|
Up to 2 years in total |
Maximum 1 year per individual report |
|
Data retained for up to 3 years |
Maximum date range per request is 100 days |
|
No stated limit |
Start date and end date cannot be the same; when fetching a single day, set the start date to the day before and filter the results accordingly |
|
Up to 37 months |
Reach metrics with breakdown dimensions (age, gender, country, placement, device) are limited to the last 13 months |
|
Up to 2 years |
Fetches, including scheduled fetches, cannot exceed a 2-year date range |
|
No stated limit |
Change Event reports are limited to the last 30 days by Google Ads. Call Metrics Call Details reports can only be collected using a lifetime date range |
|
Varies by report type |
Forecast metrics up to 365 days, historical metrics up to 48 months, and keyword ideas up to 12 months |
|
No stated limit |
Data is available back to the creation of the Google Analytics 4 property. The data retention setting in Google Analytics 4 does not limit what this connector collects, because it applies to explorations and funnel reports rather than to the aggregated reports the connector uses |
|
Varies by report type |
See Google Campaign Manager 360 below |
|
Varies by report type |
See Google Display & Video 360 below |
|
No stated limit |
When backfilling, fetch in increments of no more than one year at a time and wait for each fetch to complete before starting the next |
|
Up to 10 years, 25 months for demographic pivots |
A single fetch cannot cover more than 25 months. Permanently deleted campaigns are not returned by the API and cannot be fetched historically |
|
No stated limit (without Hour dimension) |
When the Hour dimension is selected, the lookback window is limited to 45 days |
|
Varies by granularity |
See Microsoft Ads below |
|
Up to 3 years per request |
— |
|
Varies by granularity and report type |
See Pinterest below |
|
Up to 24 months |
Reach and frequency data is only available from June 2024 |
|
Delivery Insights data available from 1 January 2020 |
See Snapchat below for metric-level cutoffs and retention limits |
|
Varies by granularity |
See Spotify Ads below |
|
Hourly data retained for 90 days |
For data older than 90 days, use daily or higher granularity |
|
Data Element reports limited to a maximum date range of 100 days |
Maximum of 100 report schedules per partner API account |
|
No stated limit |
The date range of a single fetch cannot exceed 365 days |
|
Up to 90 days per request for some endpoints |
To fetch longer periods, split the fetch into multiple 30-day windows |
|
Varies by report type; most standard report types support several years |
See the Xandr documentation for per-report retention details |
|
Up to 3 years prior to the current month |
— |
Connectors with granularity or report-type dependent limits#
Amazon Selling Partner#
The availability of historical data depends on the report type:
Search Query Performance report type has a data lookback window of 17 months.
Apple Search Ads#
The availability of historical data depends on the report granularity:
For weekly and monthly granularity, historical data is available for up to 24 months.
For daily granularity, historical data is available for up to 90 days.
For hourly granularity, historical data is available for up to 30 days.
Google Campaign Manager 360#
The availability of historical data depends on the report type:
Data availability |
Report types |
|---|---|
730 days |
Most reporting data, including Reach and Unique Reach reports |
60 days |
Floodlight reports, Path to Conversion (P2C) reports, and The Attribution Modeling Tool |
31 days |
Keyword data |
Google Display & Video 360#
The availability of historical data depends on the report type:
Data availability |
Report types |
|---|---|
730 days |
Most reporting data, including Reach and Unique Reach reports |
60 days |
Floodlight reports and Keyword data |
Reach reports are limited to 93 days unless they include a Date, Week, or Month dimension. Including one of these dimensions removes the 93-day limit.
If the date range of a fetch starts before the limit that applies to the report type, Adverity moves the start date forward to the earliest available date and logs a warning. If the whole date range is outside the limit, the fetch fails.
Unique Reach metrics cannot be collected for dates before 1 April 2024.
Microsoft Ads#
The availability of historical data depends on the report granularity:
For daily, weekly, monthly, yearly, and aggregated reports, historical data is available for up to 36 months.
For hourly reports, historical data is available for up to 6 months.
Some report types are retained for shorter periods than this. For example, hourly data for Geographic Performance and User Location Performance reports is available for 14 days, the Budget Summary Report is available for 24 months at daily aggregation only, and the Asset Performance Report is available for 30 days.
Pinterest#
The availability of historical data depends on the report granularity and type:
For non-hourly granularity, you can fetch data from up to 914 days before the current date. The maximum date range per request is 186 days.
For hourly granularity, you can fetch data from up to 8 days before the current date. The maximum date range per request is 3 days.
For product-level (
PRODUCT_ITEM) reports, you can fetch data from up to 92 days before the current date. The maximum date range per request is 31 days.
Snapchat#
Snapchat data availability depends on the metric type:
Delivery Insights data is available from 1 January 2020. Some metrics have later availability start dates:
Country and OS metrics breakdown is available from 24 October 2022.
Viewability metrics are available from 1 April 2021.
Reach metrics do not support monthly aggregation.
Data collected via Lead Gen Ads is not stored for more than 30 days.
Spotify Ads#
The maximum date range per request depends on the selected time granularity:
For Lifetime and Day granularity, the start and end date must be within 90 days of each other.
For Hour granularity, the requested date range must fall within the last 2 weeks.