sync and limits

Understanding how SpendGuard syncs your ad data and the limits that apply.

What Gets Synced

When you connect a platform or trigger a manual sync, SpendGuard syncs:

Ad Accounts

• All ad accounts accessible with your credentials

• Account status and metadata

Campaigns

• All campaigns (excluding archived/deleted)

• Campaign status, name, and configuration

Ad Groups

• All ad groups (Meta: Ad Sets, excluding archived/deleted)

• Ad group status, name, and parent campaign

Ads

• All ads (excluding archived/deleted)

• Ad status, name, URLs, and parent ad group/campaign

Sync Process

Initial Sync

1

Initial connection: account selection & sync

• Ad accounts are synced immediately.

• You select a default account.

• A full sync is automatically triggered for the default account.

• This sync includes campaigns, ad groups, and ads.

Manual Sync

1

Trigger a manual full sync

• Go to Settings → Connections

• Click on a connection to view details

• Click Sync Now next to the default account

• Wait for sync to complete (may take a few minutes)

Full syncs are rate-limited to prevent API quota issues.

Rate Limiting

Why Rate Limiting Exists

• API Quotas — Ad platforms have daily API call limits

• Prevent Overload — Protects against excessive API usage

• Fair Usage — Ensures all users can access the platform

Sync Cooldowns

Full syncs have cooldown periods:

• Meta Ads: 6 hours between full syncs

• Google Ads: 24 hours between full syncs

Cooldowns only apply to manual full syncs. Initial syncs after connection are not rate-limited.

What Happens During Cooldown

If you try to sync during the cooldown period:

• The sync button is disabled

• A message shows when the next sync will be available

• You can see the last sync time

Plan Limits

Your plan may have limits on:

• Number of Connections — How many platforms you can connect

• Number of Ads — Maximum ads that can be synced

• Number of Products — Maximum products per guard

• Number of Guards — Maximum guards you can create

Check your plan details in the Settings → Billing section.

Sync Status

Last Synced

Shows when the account was last fully synced. This includes:

• Campaigns

• Ad groups

• Ads

Sync Requested

Shows when a sync was requested (may be in progress):

• Sync button shows "Syncing..." when active

• Status updates when sync completes

Understanding Sync Times

Why Syncs Take Time

• Large Accounts — Accounts with many campaigns/ads take longer

• API Rate Limits — Platforms limit how fast we can fetch data

• Pagination — Large datasets require multiple API calls

Typical Sync Duration

• Small Accounts (< 100 ads): 1–2 minutes

• Medium Accounts (100–1000 ads): 3–5 minutes

• Large Accounts (> 1000 ads): 5–10 minutes

Troubleshooting Sync Issues

Sync Not Starting

• Check connection status (should be "Active")

• Verify you're not in a cooldown period

• Try disconnecting and reconnecting

Sync Taking Too Long

• This is normal for large accounts

• Keep the tab open during sync

• Check the connection settings page for status updates

Ads Not Showing After Sync

• Verify the account has active ads

• Check that ads are not archived

• Ensure you've selected the correct account

For more help, see the Troubleshooting guide.

Related Topics

• Connecting Platforms - How to connect platforms

• Troubleshooting - Fixing sync issues