Skip to content
Documentation hero background

AI Agent Chat for Ad Analytics

What is AI Agent Chat?

Ask in plain English and get charts, tables, and reports instantly to guide your next move.

Key Benefits

  • Faster answers — Skip manual digging and get direct results.
  • Less debate — Share-ready charts and tables keep everyone aligned.
  • More momentum — Recommendations help move from “what happened?” to “what next?”.

Getting Started

Open AI Agent

Use the chat on your dashboard to start a session.

Ask a question

Use plain English. Example: “Show ROAS by platform for last 30 days.”

Refine with follow-ups

Ask for breakdowns, comparisons, or time ranges.

[object Object]

Generate a report and share it via URL.

Credits & Usage

AI Agent Chat uses a credit system to manage usage.

How Credits Work

ActionCredit Cost
Chat message1 credit
Report generation2 credits
First prompt per sessionFree

Credit Pools

  • Free credits — Included with your plan each month
  • Paid credits — Available on paid plans with higher limits

Usage Limits

  • Daily and monthly caps apply depending on your plan
  • Check your remaining credits in Settings > Billing & Subscription
  • When credits are exhausted, you will be notified before sending a message

Free to Try: Your first prompt in each session is free, so you can always ask one question without spending credits.


AI Agent vs. Manual Analysis (When to use which)

ScenarioUse AI Agent ChatUse manual analysis
Quick answers and visualsYes — plain-English prompts to charts/tables
Exploratory questionsYes — fast iterations with follow-ups
Deep custom analysisYes — complex, bespoke analysis
Repeatable reportingYes — generates summaries and visuals
Audit/validationYes — verify against native platforms

Your Intelligent Campaign Partner — The Flyweel AI Agent analyzes your campaign data from connected platforms and provides insights, charts, and reports using natural language.


How the AI Agent Works

The AI Agent combines natural language processing with your campaign data to:

  • Analyze Data — Processes campaign performance across all connected platforms
  • Provide Insights — Delivers recommendations based on your specific data
  • Generate Visualizations — Creates charts, tables, and visual reports on demand
  • Maintain Chat History — Remembers previous messages within a session for follow-up questions

Getting Started with AI Chat

Accessing the Agent

The AI chat interface is on your Flyweel dashboard homepage.

Locate the Chat Interface

Find the chat input box at the bottom of your dashboard homepage

Ask Your First Question

Type your question in natural language and press Enter

Review the Response

The AI will provide insights with supporting data, charts, or tables

Continue the Conversation

Ask follow-up questions to dive deeper into specific areas

Understanding AI Responses

The AI Agent presents information in multiple formats:

Response Types

  • Text Analysis — Direct answers with explanations and context
  • Interactive Charts — Visual data representations (bar charts, line graphs, pie charts)
  • Data Tables — Detailed metric breakdowns with sorting and filtering
  • Recommendations — Specific, actionable optimization suggestions

Performance Analysis Queries

Campaign Performance Questions

Spend Analysis

Ask questions like:

  • “What was my total advertising spend across all platforms last month?”
  • “Which campaigns consumed the most budget this week?”
  • “How does my current spend compare to last month?”
  • “Show me spend trends over the last 90 days”

Traffic & Engagement Analysis

  • “Which campaign had the highest click-through rate last week?”
  • “What’s my average CTR across Google Ads vs Meta Ads?”
  • “Show me impression trends for my top 5 campaigns”

Conversion Performance

  • “What’s my return on ad spend for the current month?”
  • “Which campaigns are driving the most conversions?”
  • “Show me cost per acquisition trends over time”
  • “Compare conversion rates between platforms”

Comparative Analysis

Platform Performance

Cross-Platform Insights: The AI excels at comparing performance between Google Ads and Meta Ads, identifying platform-specific strengths and optimization opportunities.

  • “Compare the performance of my Google Ads and Meta Ads campaigns”
  • “Which platform is more cost-effective for my business?”
  • “Show me CTR differences between Search and Facebook campaigns”

Time-Based Comparisons

  • “How did this month’s performance compare to last month?”
  • “Show me week-over-week changes in key metrics”

Optimization & Strategy Questions

Identifying Opportunities

Underperformance Analysis

  • “Which campaigns are underperforming and need attention?”
  • “Show me campaigns with high spend but low conversions”
  • “Identify ads with declining click-through rates”

Growth Opportunities

  • “Where can I improve my return on ad spend?”
  • “Which campaigns have room for budget increases?”

Strategic Recommendations

Budget Optimization

Smart Budget Allocation: The AI can recommend budget reallocation strategies based on performance data, helping you maximize ROI across all campaigns.

  • “How should I reallocate my advertising budget for better performance?”
  • “Which campaigns deserve more budget based on their efficiency?”

Generating Reports

How Reports Work

The AI Agent can generate standalone reports that are saved to your report history and can be shared via URL.

  1. Ask the AI to generate a report: “Generate a report of my campaign performance for the last 30 days”
  2. The AI creates a formatted report with charts and analysis
  3. The report appears in your report history
  4. Share the report via its unique URL

Report Examples

  • “Create an executive summary of advertising ROI”
  • “Generate a performance comparison between Google and Meta”
  • “Summarize performance improvements over the quarter”

Report Credits: Generating a report costs 2 credits. Reports are saved to your history and can be shared with anyone via URL.


Chat History

The AI Agent maintains message history within your session:

  • Session History — Remembers previous messages and responses within a session
  • Follow-up Questions — You can reference earlier parts of the conversation
  • Clear Chat — Start a fresh conversation for unrelated analysis

Best Practices

Asking Effective Questions

Be Specific

  • Good: “Show me conversion rates for my Google Search campaigns in December”
  • Vague: “How are my campaigns doing?”

Provide Context

  • Good: “Compare this month’s ROAS to last month for campaigns spending over $1000”
  • Limited: “Show me ROAS”

Use Natural Language

  • Good: “Which of my Facebook campaigns are wasting the most money?”
  • Also Good: “Identify my least efficient Meta Ads campaigns”

Conversation Flow: Start with broad questions and progressively narrow your focus. The AI will maintain context within the session.


Troubleshooting & Support

Common Issues

AI Response Accuracy

  • Data Freshness — AI responses reflect data last synchronized from platforms
  • Platform Delays — Some metrics may have reporting delays
  • Attribution Differences — Results may vary based on platform attribution models

Query Understanding

  • Clarification Requests — AI may ask for clarification on ambiguous questions
  • Context Limits — Very complex queries may need to be broken into smaller questions

Getting Better Results

  • Use Specific Timeframes — “Last 30 days” vs “recently”
  • Specify Platforms — “Google Ads” vs “all campaigns”
  • Include Metric Definitions — “ROAS above 3.0” vs “good ROAS”
  • Reference Campaign Names — Use exact campaign names when possible

Data Interpretation: While the AI provides data-driven analysis, always validate critical business decisions against your platform data.


Next Steps

  1. AdGrid Campaign Manager — View detailed campaign data
  2. Reports & Analytics — View report history and share reports
  3. Integrations — Connect more platforms for richer AI analysis

Frequently Asked Questions

How does the AI Agent access my advertising data?

The AI Agent connects to your linked Google Ads and Meta Ads accounts through secure API integrations, analyzing your campaign data to provide insights and recommendations.

Can the AI Agent make changes to my campaigns?

No. The AI Agent is read-only and cannot modify campaigns, adjust budgets, or change settings. It provides insights and recommendations that you implement in your ad platforms.

How much does the AI Agent cost to use?

Each chat message costs 1 credit and each report costs 2 credits. Your first prompt per session is free. Credit limits depend on your plan — check Settings > Billing & Subscription for your current balance.

Does the AI Agent remember previous conversations?

The AI maintains message history within a single session, allowing follow-up questions. Start a new chat to clear context for unrelated topics.

Can I use natural language or do I need specific commands?

The AI understands natural conversational language. Ask questions as you would to a team member: “Why is my CPA increasing?” or “Show me my best Facebook campaigns.”

How is the AI Agent different from just looking at reports?

The AI answers complex questions instantly, identifies patterns you might miss, and generates visual reports on demand — all through natural language.

What if the AI doesn’t understand my question?

The AI will ask clarifying questions. Try rephrasing with more specific details (time periods, campaign names, metrics) or break complex queries into smaller questions.

Is my data secure when using the AI Agent?

Yes. All data is encrypted and securely processed. The AI only accesses campaign performance data from your connected accounts.


Ready to get insights? Start chatting with the Flyweel AI Agent and discover intelligent insights about your advertising performance.

Ready to get started?

Start optimizing your ad spend today with Flyweel.