Data Warehousing
Data warehousing is how AgencyAnalytics stores your clients' data so it can be quickly and reliably pulled into dashboards and reports. Instead of asking each integration's API for data every time you open a report, AgencyAnalytics fetches it on a schedule and stores it. This means:
Shorter load times on dashboards and reports that use warehoused integrations
More consistent reporting across integrations with different API rules
In many cases, more history than the integration's API would normally provide
Before You Start
Data warehousing only begins after you've connected a supported integration to a Client in AgencyAnalytics. If you haven't connected the integration yet, do that first.
Some integrations are only partly warehoused. For example, HubSpot web traffic, forms, and email data, as well as Google Local Services Ads cost and call data, are pulled live from the integration rather than being warehoused.
Historical Data by Integration
The table below shows how many days of history AgencyAnalytics loads when you first connect each warehoused integration.
For some integrations, such as Yelp Ads, HubSpot, and StackAdapt, stored history keeps growing past this number over time. Others, such as TikTok Ads and Simpli.fi, only show data up to this limit in reports.
Integration | Days of Historical Data Warehoused |
Amazon Ads | 60 |
BigCommerce | 365 |
Brevo | 1 |
CallRail | 730 |
ConvertKit | 1 |
Google Ad Manager* | 365 |
Google Display & Video 360** | 365 |
Google Local Services Ads | 365 |
GroundTruth | 365 |
HubSpot | 730 |
Pinterest Ads | 365 |
Reddit Ads | 730 |
Shopify | 730 |
Simpli.fi | 365 |
Snapchat Ads | 365 |
StackAdapt*** | 365 |
TikTok† | 60 |
TikTok Ads | 365 |
WooCommerce | 730 |
WhatConverts | 730 |
X Ads | 730 |
Yelp Ads | 88 |
YouTube†† | 1,095 |
* Creative Advertisers and Order Line Items data from Google Ad Manager has 1 day of historical data warehoused.
** Apps & URLs data from Google Display & Video 360 (DV360) has 31 days of historical data warehoused, due to Google API limitations.
*** City, Country, Demographic, Device, Supply Source, and Zip Code data from StackAdapt has 1 day of historical data warehoused.
† Content, Content Demographic, and Profile Demographic data from TikTok has 1 day of historical data warehoused.
†† Total Subscribers and Channel Videos data from YouTube has 1 day of historical data warehoused.
How Data Warehousing Works
Once you connect a supported integration to a Client, AgencyAnalytics begins pulling your data immediately.
Stage 1: Connect the integration, then open its prebuilt integration dashboard or add widgets that use its data. While the first data loads, the widgets display the Initializing window.
Stage 2: AgencyAnalytics loads your most recent days and older history simultaneously. Older history loads backward in batches, so it stays within each integration's API limits. Once some data is in, some widgets can show "Please wait while your data is retrieved...".
This usually takes a few days and can take longer for large accounts or integrations with strict API limits, such as Simpli.fi.
Stage 3: Track loading progress with the status label in the dashboard header. While history is still loading, it shows Loading history and a progress bar. See the next section for details.
When New Data Shows Up
Most integrations load data in whole days, based on UTC time. This means:
Today's data usually isn't available yet
Yesterday's data arrives after a delay that depends on the integration, for example, about 18 hours for TikTok and about 22 hours for Yelp
Some integrations, like TikTok Ads, will always look about 1 day behind
Shopify orders, HubSpot, and BigCommerce are exceptions and do load part of today's data.
AgencyAnalytics also fetches the last few days again on each sync, so recent numbers can still change as the integration finalizes its data.
Check Your Data Sync Status
The status label shows whether a warehoused integration is up to date.
Step 1: Open a Client, then go to the integration's dashboard.
Step 2: Click the status label in the dashboard header, just to the left of the date picker.
Step 3: Review the details in the popup.
What Each Status Means
🟢 Healthy | A green dot means data is syncing normally, for example, "Synced 3h ago." No action needed. |
🔴 Stopped | A red dot shows "Sync failed," along with the cause, a suggested action, and when we'll check again. For example, "We'll check again within 6 hours." |
🟡 Stale | A yellow dot shows "Syncing behind." Nothing has failed, but the data hasn't updated as recently as expected. |
Still Loading | A blue loading spinner shows "Data before [date] is still loading" with a progress bar. The date is the earliest date loaded so far. This is temporary while a new connection loads its history. |
Some integrations only load data for full days, so today’s data won’t appear until the day ends. For these integrations, the status popup shows “Today’s data comes after the day ends.”
Data Warehousing Privacy and Security
All warehoused data is encrypted at rest by default. For each integration, we load history back to the limit shown in the table above, then store each new day as it comes in so your data stays up to date. Data older than an integration's limit isn't available in your reports.
AgencyAnalytics only pulls data from external platforms. We never push data to them or change it, so your original data sources are never affected.
FAQ
What happens if my integration disconnects?
If an integration only disconnects, your warehoused data isn't deleted. Simply reauthorize the connection and syncing picks up where it left off.
Simpli.fi is an exception. Its API limits how many days can be pulled at a time, so if it stays disconnected for a while, it can take some time to catch up after you reconnect.
Is warehoused data ever deleted automatically?
Yes, in these cases:
If a Client or connection is deleted, its data is deleted after about 60 days
If your account is suspended, its data is deleted after about 120 days
If a connection is removed and added again, the old data is deleted and the full history loads again from scratch
To avoid reloading history, reauthorize an existing connection instead of removing and re-adding it.
How do I delete warehoused data?
You can't manually delete warehoused data. This prevents accidental deletions that could disrupt your client reporting. To request deletion, contact our Support team.
Why isn't today's data showing yet?
Most integrations load entire days in UTC, so today's data isn't available yet, and yesterday's data can take several hours to arrive. Learn more in When New Data Shows Up above.
Why did my numbers for the last few days change?
AgencyAnalytics fetches the last few days again on each sync, so recent numbers update as the integration finalizes its data.
Why doesn't my report's date range change some metrics?
Data marked as 1 day in the table above is a current or lifetime total, so the date range doesn't filter it.
Why don't I see the status label on some of my integrations?
The status label appears only for warehoused integrations and only on integration dashboards and Client pages. It doesn't appear in reports, PDFs, or custom dashboards.
What's the amber triangle in a widget header?
That's a different warning. It means the integration only keeps the last few days of data, for example, "only retains the last 30 days." It isn't related to the sync status label.
What should I do if my integration shows Sync failed?
Click the status label and follow the suggested action in the popup. Often this means reauthorizing the connection. AgencyAnalytics will also check again automatically. If it keeps failing, contact our Support team.
Does the status popup show a clock time for the next data update?
It depends on why the data is updating:
When the date range includes today: the status popup shows when today’s data will update next, such as “Today’s data updates every _ hours, next around 3:15 PM.” The time is shown in your own time zone.
When a data update fails: the status popup shows the next retry as a time window rather than a clock time.
Can I see error codes or technical details about why a sync failed?
The status label uses plain language and doesn't show error codes. If a widget shows an error screen, it includes a Reference ID you can copy. Share that ID with our Support team so they can look into it faster.
Does AgencyAnalytics send or push data back to external platforms?
No. AgencyAnalytics only reads data from your connected platforms and never writes or changes data in them.
What to Check Out Next
Reconnect a disconnected integration with Reauthorize or Reconnect a Data Source
💬 Need additional help?
If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄



