Troubleshooting Guide
Solutions to common issues with platform connections, data synchronization, automation, and general account problems.
Before You Start
Most issues can be resolved quickly by checking a few common causes. Before diving into specific troubleshooting steps, try these universal solutions that fix the majority of problems:
Clear Cache & Hard Refresh
Press Ctrl + Shift + R (Windows/Linux) or Cmd + Shift + R (Mac) to force-reload the page. This clears cached data that may be causing display issues.
Check System Status
Visit status.zaplane.io to see if there are any ongoing platform issues or scheduled maintenance. If services are degraded, wait for resolution rather than troubleshooting.
Try Incognito/Private Mode
Open an incognito window and log in. If the issue disappears, it's likely caused by a browser extension or corrupted cookies. Clear your cookies for zaplane.io or disable extensions.
Platform Connection Issues
"Unable to Connect" or "Authorization Failed" Errors
Common Causes:
- •Wrong account login: You're logged into a different account than the one you want to connect. Sign out of all accounts on the platform, then start OAuth fresh.
- •Insufficient permissions: You need admin access to the advertising account. Contact your account administrator.
- •Pop-up blocked: Your browser blocked the OAuth window. Allow pop-ups for zaplane.io and try again.
- •Third-party cookies disabled: OAuth requires third-party cookies. Enable them in browser settings for the platform you're connecting (e.g., google.com, facebook.com).
Step-by-Step Fix:
- Sign out of ALL accounts on the advertising platform (e.g., sign out of all Google accounts)
- Close all browser tabs for that platform
- Return to Zaplane Insights → Settings → Integrations
- Click "Connect" and log in to the correct account when prompted
- Grant all requested permissions
Connection Successful But No Campaigns Appear
Troubleshooting Steps:
1. Check Initial Sync Status
Go to Settings → Integrations and look for the sync status next to your connected platform. Initial sync can take 10-30 minutes for large accounts. If status shows "Syncing...", wait for completion.
2. Verify Account Selection
After OAuth, you should have selected which accounts/campaigns to import. Click "Manage" next to the platform and verify accounts are selected (checkboxes enabled).
3. Confirm Active Campaigns
Log into the advertising platform directly and verify you have active campaigns with recent activity. Zaplane only imports campaigns with data from the past 90 days.
4. Retry Sync
In Settings → Integrations, click the "⋮" menu next to the platform and select "Force Resync". This manually triggers a fresh data import.
"Token Expired" or "Re-authentication Required"
OAuth tokens expire periodically (every 30-60 days depending on the platform). Zaplane Insights automatically refreshes them, but if you've changed your password or revoked permissions on the platform, manual re-authentication is required.
Fix:
Go to Settings → Integrations, click "Reconnect" next to the affected platform, and log in again. Your campaign settings and historical data are preserved.
Data Sync Issues
Data Appears Outdated or Delayed
Zaplane Insights syncs campaign data every 4 hours for most platforms. Google Ads and Meta data may have a 1-2 hour delay from their own APIs. If data appears more than 6 hours old, there may be a sync issue.
Check Last Sync Time:
Settings → Integrations → Look for "Last synced: X hours ago" below each platform. If it says "Syncing..." for more than 1 hour or "Last synced: 12+ hours ago", force a resync or contact support.
Missing Campaigns or Ad Groups
Zaplane filters out paused campaigns with no activity in the past 90 days to reduce clutter. To view all campaigns including paused:
- Go to your dashboard
- Click the "Filter" button (funnel icon)
- Under "Status", select "All" instead of "Active only"
- Apply filters
Metrics Don't Match Platform Dashboard
Small discrepancies (1-2%) are normal due to timing differences and rounding. Larger differences may indicate:
- •Date range mismatch: Verify you're comparing the same date range. Zaplane uses account timezone by default.
- •Attribution window: Conversion tracking may use different attribution windows. Check Settings → Conversion Settings to match your platform's configuration.
- •Currency conversion: If you run multi-currency campaigns, ensure Zaplane's conversion rates match your expectations (updated daily from exchange rate APIs).
AI & Automation Issues
No AI Recommendations Generated
The AI requires minimum data thresholds before generating recommendations:
- At least 7 days of campaign data
- Minimum $50 in daily spend
- At least 10 conversions in the past 30 days (for conversion-based recommendations)
If you meet these thresholds but still see no recommendations after 48 hours, check that AI optimization is enabled in Settings → AI Configuration → Enable AI Recommendations.
Automation Not Running on Schedule
Automated optimizations run according to your plan tier (Starter: 1x/week, Professional: 4x/week, Enterprise: daily). If automation isn't running:
Verification Steps:
- Go to Settings → Automation → Check "Automation Status" toggle is ON
- Verify approval thresholds aren't blocking all changes (e.g., $0 threshold blocks everything)
- Check your plan's automation schedule in Settings → Subscription
- Review recent automation runs in AI Hub → Orchestration Logs
Approved Recommendations Not Applied
After approving a recommendation, changes typically apply within 5-15 minutes. Check the recommendation status in AI Hub → Recommendations. If status shows "Failed", click to view error details. Common causes: platform API rate limits, insufficient account permissions, or campaigns paused since recommendation was generated.
Dashboard & Display Issues
Charts Not Loading or Showing "No Data"
- •Check your date range filter. If set to "Today" and it's early morning, data may not be available yet.
- •Verify campaign filters. If you've filtered to specific campaigns, ensure they have data for the selected period.
- •Try refreshing with Ctrl+Shift+R (hard refresh) to clear cached chart data.
Page Loads Slowly or Times Out
Large accounts with 100+ campaigns may experience slower dashboard loads. Optimize performance by:
- Using campaign filters to view subsets of data
- Shortening date ranges (e.g., 30 days instead of 90 days)
- Archiving very old paused campaigns in Settings → Campaign Management
Broken Layout or Missing Elements
This usually indicates cached CSS/JavaScript. Clear your browser cache completely: Settings → Privacy → Clear Browsing Data → Check "Cached images and files" → Clear for "All time". Then refresh the page.
Login & Account Access Issues
"Invalid Email or Password" Error
Double-check your email for typos. If you're certain the credentials are correct:
- Click "Forgot Password?" to reset
- Check your spam folder for the reset email
- If no email arrives within 5 minutes, verify you're using the correct email address (check your welcome email from Zaplane)
- Still stuck? Contact support@zaplane.io with your account email
Two-Factor Authentication Issues
If your 2FA code isn't working:
- •Ensure your device's time is accurate (2FA codes are time-sensitive)
- •Use a backup code from your initial 2FA setup
- •Contact support with identity verification to temporarily disable 2FA
Account Locked or Suspended
Accounts are locked after 5 failed login attempts (security measure) or suspended due to payment failure. For lockouts, wait 30 minutes then try again. For payment suspensions, update your payment method in the email notification link.
Still Need Help?
If the solutions above don't resolve your issue, our support team is here to help. When contacting support, please include:
- Your account email (so we can look up your account)
- Clear description of the problem
- Steps to reproduce (if applicable)
- Screenshots or error messages
- Browser and version (e.g., Chrome 120, Safari 17)
Email Support
support@zaplane.io
Response within 4 hours (business days)
Live Chat
Click the chat icon in bottom-right corner
Available 9 AM - 6 PM ET, Mon-Fri
Was this article helpful?
Still need help?
Our support team is here to assist you