Skip to main content

Part 7: Frequently Asked Questions

This section collects the most common issues and solutions users encounter when using InsightHub.

Login and Authentication​

Q1: What should I do if I see "Redirect URI mismatch" when logging in?​

Problem Description: After clicking the login button, the browser displays an OAuth error indicating redirect URI mismatch.

Possible Reasons:

  • The OAuth client ID configured in Google Cloud Console doesn't include the current access domain
  • Local development environment uses a different port number

Solutions:

  1. Check the current access URL (e.g., http://localhost:5173 or production domain)
  2. Visit Google Cloud Console > APIs & Services > Credentials
  3. Find the corresponding OAuth client ID and click Edit
  4. Add the current URL (without path) to Authorized JavaScript origins
  5. Add the complete callback URL to Authorized redirect URIs
  6. Save changes (may take a few minutes to take effect)

Detailed Documentation: Refer to Google Cloud Configuration Guide

Q2: Unable to access feature pages after login?​

Problem Description: Login successful, but clicking feature menu has no response or displays errors.

Possible Reasons:

  • Browser cache issues
  • Permission configuration issues
  • Backend service not started (local development environment)

Solutions:

  1. Clear browser cache and cookies
  2. Check browser console for error messages
  3. If in local development, confirm backend service is started (http://localhost:8080)
  4. Try logging in again using incognito mode

Data Analysis​

Q3: Nothing happens after uploading a file?​

Problem Description: After clicking to upload a file, the page doesn't show upload progress or file information.

Possible Reasons:

  • Unsupported file format
  • File too large
  • Browser compatibility issues
  • Network issues

Solutions:

  1. Check file format:
    • Market Opportunity Analysis: Supports .xlsx format
    • Audience Signal Analysis: Supports .xlsx or .csv format
    • Persona Slide: Supports .xlsx format
  2. Check file size: Recommended single file not exceeding 10MB
  3. Check browser console: Check for error messages
  4. Try other browsers: Recommended to use latest versions of Chrome or Edge
  5. Check network connection: Ensure network connection is normal

Detailed Documentation: Refer to each feature's User Guide

Q4: What if analysis takes too long?​

Problem Description: After clicking "Start Analysis," the progress bar doesn't update for a long time, or analysis time exceeds expectations.

Possible Reasons:

  • Data volume too large
  • AI API slow response
  • Network issues
  • High system load

Solutions:

  1. Reduce data volume:
    • Market Opportunity Analysis: Reduce number of countries to analyze (recommended 5-10 countries)
    • Audience Signal Analysis: Reduce number of queries
    • Persona Slide: Reduce number of Personas
  2. Check network connection: Ensure network connection is stable, VPN is correctly configured
  3. Wait time:
    • Market Opportunity Analysis: Usually 1-3 minutes
    • Audience Signal Analysis: Usually 2-5 minutes
    • Persona Slide: Usually 3-8 minutes (depends on number of Personas)
  4. If exceeding 10 minutes:
    • Refresh page and retry
    • Check browser console error messages
    • Contact technical support

Q5: Analysis results inaccurate or don't meet expectations?​

Problem Description: Analysis completed, but results don't match expectations, or some data wasn't correctly identified.

Possible Reasons:

  • Incorrect data format
  • Poor data quality
  • AI understanding deviation

Solutions:

  1. Check data format:
    • Confirm all required columns exist
    • Check if column names are correct (supports Chinese and English)
    • Check if data types are correct (numeric, text, boolean)
  2. Check data quality:
    • Confirm no null values or outliers
    • Check if numeric ranges are reasonable
    • Confirm categorical field values meet expectations
  3. View detailed documentation: Refer to each feature's User Guide to understand data format requirements
  4. Provide feedback: If data is confirmed correct, you can report issues through the feedback function

Export and Download​

Q6: Export to Google Drive failed?​

Problem Description: After clicking "Export to Google Drive," error displayed or no file created.

Possible Reasons:

  • Google Drive API permission issues
  • Insufficient storage space
  • Network issues

Solutions:

  1. Check permissions:
    • Confirm app has been authorized to access Google Drive
    • Check app permissions in Google account settings
  2. Check storage space: Confirm Google Drive has sufficient storage space
  3. Retry operation: Network issues may cause failure, can retry
  4. Use other export methods:
    • Export as PPTX file and download locally
    • Export as ZIP file and download locally

Detailed Documentation: Refer to each feature's User Guide

Q7: Downloaded files cannot be opened?​

Problem Description: After downloading PPTX or ZIP files, cannot open or files are corrupted.

Possible Reasons:

  • Incomplete download
  • File format issues
  • Decompression software issues

Solutions:

  1. Re-download: Delete old file, re-export and download
  2. Check file size: Confirm file size is normal (not 0KB)
  3. Check file format:
    • PPTX files need Microsoft PowerPoint or compatible software to open
    • ZIP files need decompression software (such as WinRAR, 7-Zip) to extract
  4. Try other browsers: Some browsers may handle downloaded files incorrectly

Performance and Errors​

Q8: Page loads slowly?​

Problem Description: Opening pages or switching features takes a long time to load.

Possible Reasons:

  • Network issues
  • Browser cache issues
  • High system load

Solutions:

  1. Check network connection: Ensure network connection is normal, VPN is correctly configured
  2. Clear browser cache:
    • Chrome/Edge: Ctrl+Shift+Delete (Windows) or Cmd+Shift+Delete (Mac)
    • Select "Cached images and files," clear cache
  3. Use latest browser: Ensure using the latest browser version
  4. Check system resources: Close other resource-consuming tabs or applications

Q9: Page displays error messages?​

Problem Description: Page displays error prompts such as "Network error," "Service unavailable," etc.

Possible Reasons:

  • Backend service not started (local development)
  • API service exception
  • Network issues

Solutions:

  1. Check backend service (local development):
    • Confirm backend service is started (http://localhost:8080)
    • Check backend logs for errors
  2. Check network connection: Ensure network connection is normal
  3. View error details:
    • Open browser developer tools (F12)
    • Check Console and Network tabs
    • Record error information and contact technical support
  4. Retry operation: If temporary network issue, can refresh page and retry

Q10: Browser console displays errors?​

Problem Description: Opening browser developer tools, Console shows red error messages.

Solutions:

  1. Record error information: Copy complete error information
  2. Check error type:
    • Network errors: Check network connection and backend service
    • Permission errors: Check login status and API permissions
    • Code errors: Contact technical support
  3. Provide context:
    • Record operation steps
    • Record time when error occurred
    • Provide browser and operating system information
  4. Contact technical support: Provide error information to technical support team

Data Format​

Q11: How to prepare data for Market Opportunity Analysis?​

Data Requirements:

  • File format: .xlsx
  • Required columns: Category name, Country name, Market competition (CPC), Clicks, Clicks (PoP), Market demand median, Market competition median, Market competition growth median, Is high competition, Is high demand, Market type

Detailed Instructions: Refer to Market Opportunity Analysis Deep Dive Guide

Q12: How to prepare data for Audience Signal Analysis?​

Data Requirements:

  • File format: .xlsx or .csv
  • Required columns: Query (search terms), Affinity Search, In-Market Search, and other dimensional data

Detailed Instructions: Refer to Audience Signal Analysis Deep Dive Guide

Q13: How to prepare data for Persona Slide?​

Data Requirements:

  • File format: .xlsx
  • Required columns: Persona-related information (name, age, interests, behavior, etc.)

Detailed Instructions: Refer to Persona Slide Deep Dive Guide

Other Questions​

Q14: How to understand market types in analysis results?​

Market Type Descriptions:

  • Opportunity Market: High demand, low competition, best entry opportunity
  • Challenge Market: High demand, high competition, requires full preparation
  • Potential Market: Low demand, low competition, requires cultivation
  • Blue Ocean Market: Low demand, high competition, requires careful evaluation

Detailed Instructions: Refer to Market Opportunity Analysis Deep Dive Guide

Q15: How to contact technical support?​

Contact Methods:

  1. Submit issues through the feedback function in the system
  2. Ask questions in team communication channels (such as Slack, email)
  3. Create issues in GitHub Issues (if you're a developer)

Information to Provide:

  • Problem description
  • Operation steps
  • Error messages (if any)
  • Browser and operating system information
  • Screenshots (if any)

Need More Help?​

If the above questions cannot solve your problem:

  1. Consult the Quick Start guide
  2. View detailed User Guide
  3. Refer to the troubleshooting section in Development Guide
  4. Contact technical support team