Hero AI Connection & Performance Issues
Hero AI Stops Mid-Response
Symptoms:
Hero AI stops talking mid-sentence or mid-analysis
Response appears incomplete but no error message
Cursor stops blinking but conversation seems normal
This is Normal Behavior! Hero AI sometimes pauses during long responses - think of it as the AI being a bit shy or taking a breath.
Simple Solution: Just type "continue", "keep going", or "finish that thought" and Hero AI will pick up right where it left off. No need to restart anything!
Actual Technical Issues
Symptoms:
Typing indicator shows for more than 60 seconds with no response
"Network timeout" or "Request failed" error messages
Hero AI completely stops responding to new messages
Solutions:
Refresh the page: This fixes most connectivity issues
Start a new chat: Click the "New Chat" button (↻) to reset everything
Check your connection: Verify your internet is working properly
Try incognito mode: Rules out browser extension conflicts
Technical Details: Hero AI uses streaming responses with a 65,536 token limit and 30-second timeout. True timeouts require page refresh.
Slow Response Times
Symptoms:
Hero AI takes longer than 30 seconds to respond
Partial responses that seem incomplete
Multiple retry attempts needed
Solutions:
Simplify your request: Ask for smaller date ranges or specific campaigns
Use Analysis Mode: For complex analysis, use Agent Mode's structured approach
Check account size: Large accounts (100+ campaigns) may require longer processing
Try off-peak hours: API performance varies throughout the day
Analysis Processing Failures
Symptoms:
"Failed to generate analysis" errors
Hero AI gets stuck on "Processing..."
Incomplete keyword clustering or campaign analysis
Solutions:
Verify data access: Ensure your Google Ads account has recent campaign data
Check date ranges: Use date ranges with sufficient data (minimum 7 days recommended)
Restart analysis: Switch to Planning mode and begin a fresh analysis
Authentication Issues
Google Ads Connection Problems
Symptoms:
"Authentication failed. Please reconnect your Google Ads account"
"No refresh token found" errors
Redirected to login unexpectedly
Solutions:
Reconnect Google Ads: Go to Settings → Google Ads Management → Add Account
Check permissions: Ensure your Google account has access to the Google Ads account
Clear browser cache: Clear site data and cookies for Hero Marketer
Use incognito mode: Test in an incognito/private browsing window
Session Expiration
Symptoms:
Random logouts during Hero AI conversations
"Session expired" messages
Need to re-authenticate frequently
Solutions:
Stay active: Interact with Hero AI regularly to maintain session
Refresh manually: Refresh the browser tab if inactive for extended periods
Check login status: Verify you're still logged in to Hero Marketer
Rate Limiting & Performance
API Quota Issues
Symptoms:
"Rate limit exceeded. Please try again in X seconds"
"Quota exceeded" errors
Temporary service unavailable messages
Hero AI automatically handles rate limiting with:
Exponential backoff retry logic (1s, 2s, 4s, 8s delays)
Automatic retry for up to 3 attempts
Respect for API retry-after headers
Solutions:
Wait and retry: Hero AI will automatically retry after the specified delay
Reduce request frequency: Space out your requests by a few seconds
Use Analysis Mode: More efficient for complex analysis than repeated Chat requests
Data Loading Delays
Symptoms:
Hero AI says "Loading account settings..." for extended periods
Campaign data appears incomplete
Metrics don't match Google Ads dashboard
Solutions:
Check Google Ads data: Verify your campaigns have recent data in Google Ads
Refresh account: Go to Settings to refresh your account connection
Wait for sync: New campaigns may take up to 24 hours to appear in Hero AI
Data Sync Issues
Missing Campaign Data
Symptoms:
Hero AI reports "No campaigns found"
Recent campaigns don't appear in analysis
Performance data shows zeros or N/A
Solutions:
Verify Google Ads status: Check if campaigns are active and have spend
Check date ranges: Ensure you're querying dates when campaigns were active
Confirm permissions: Verify account access in Google Ads
Review account selection: Ensure you've selected the correct Google Ads account
Incomplete Performance Data
Symptoms:
Missing conversion data
Zero impressions/clicks for active campaigns
Metrics don't match Google Ads dashboard exactly
This is normal when:
Google Ads data is still processing (up to 3 hours delay)
Campaigns are very new (less than 24 hours old)
Date ranges include today's incomplete data
Solutions:
Wait for data processing: Google Ads data can be delayed up to 3 hours
Use yesterday's data: For most accurate reporting, exclude today from date ranges
Check conversion tracking: Verify conversion actions are properly configured
Analysis & Recommendation Issues
Analysis Mode Problems
Symptoms:
Planning Agent creates incomplete analysis plans
Execution Agent skips steps or groups
Recommendation Agent provides generic suggestions
Solutions:
Follow the structured flow: Complete Planning → Analysis → Recommendations in order
Use "continue" prompts: Type "continue" to move between analysis groups
Ask specific questions: Be specific about what you want to analyze
Provide context: Mention recent changes, goals, or specific concerns
Recommendation Quality Issues
Symptoms:
Generic or obvious recommendations
Suggestions don't match your business goals
Missing context about your products
Solutions:
Complete product setup: Ensure product information is configured in Settings
Provide business context: Tell Hero AI about your goals, constraints, and priorities
Use Analysis Mode: Analysis Mode provides more thorough, context-aware recommendations
Ask follow-up questions: Request specific details about implementation or expected impact
Google Ads Integration Issues
For these issues, Hero AI works with Google's official systems. When you encounter these problems, the links below provide Google's most current troubleshooting information:
API Connectivity
Google Ads API Status: Google Ads Developer Blog
API Usage Guidelines: Google Ads API Best Practices
Account Access & Permissions
Account Access Issues: Google Ads Access Troubleshooting
Manager Account Setup: Google Ads Manager Accounts
Policy & Billing Issues
Policy Violations: Google Ads Policy Center
Billing Problems: Google Ads Billing Troubleshooting
Common Google Ads Errors
Campaign Creation Issues: Campaign Setup Troubleshooting
Conversion Tracking: Conversion Tracking Setup
Getting Additional Help
Before Contacting Support
Check the Hero AI status: Look for any system-wide issues in the app
Try in incognito mode: Rules out browser-specific issues
Note the exact error message: Screenshot error messages for support
Document steps to reproduce: Record what you were doing when the issue occurred
In Hero AI Chat
You can ask Hero AI directly about specific issues:
"Why am I seeing authentication errors?"
"Help me troubleshoot missing campaign data"
"Explain this error message: [paste error]"
Advanced Troubleshooting
For persistent issues:
Check browser console: Press F12 → Console tab to see technical errors
Network issues: Check the Network tab for failed requests
Local storage: Clear Hero Marketer data from browser storage
Recovery Actions by Error Type
Authentication errors: Reconnect Google Ads account
Rate limit errors: Wait and retry automatically
Validation errors: Check your input and try again
Server errors: Refresh page or try again later
Network errors: Check internet connection
Hero AI is designed to handle most errors automatically. If issues persist, the problem may require manual intervention or indicate a temporary service disruption.