MarketMind AI is an intelligent marketing analytics and campaign management platform designed to help businesses understand advertising performance, generate high-quality marketing content, detect campaign problems, and make better budget decisions.
The platform combines campaign management, real-time analytics, artificial intelligence, reporting, content generation, data ingestion, platform integrations, billing, and secure account management in one unified workspace.
- Overview
- Core Features
- Technology Stack
- System Architecture
- Project Structure
- Requirements
- Installation
- Environment Configuration
- Running the Application
- Testing
- API Overview
- Typical User Workflow
- Security Considerations
- Background Jobs
- Current Platform Status
- Contributing
- License
Digital advertising data is often distributed across multiple platforms, dashboards, spreadsheets, and reporting tools. This makes it difficult for marketing teams to understand what is working, why performance is changing, and what action should be taken next.
MarketMind AI solves this problem by providing a centralized marketing intelligence workspace where users can:
- Monitor campaign performance across multiple advertising platforms.
- Track spend, revenue, ROAS, CTR, CPA, conversions, and other KPIs.
- Manage campaigns, ad sets, ads, budgets, and statuses.
- Upload historical campaign data through CSV files.
- Ask questions about campaign performance using natural language.
- Receive AI-powered recommendations and anomaly alerts.
- Generate platform-specific marketing content.
- Simulate campaign budget changes before applying them.
- Create downloadable AI-powered PDF reports.
- Manage connected advertising accounts.
- Securely manage authentication, passwords, two-factor authentication, and active sessions.
The Overview Canvas provides a complete high-level view of marketing performance.
The dashboard displays important marketing KPIs, including:
- Total ad spend.
- Attributed revenue.
- Average ROAS.
- Portfolio CTR.
- Total conversions.
- Average CPA.
- Number of active campaigns.
- Best-performing advertising platform.
Each KPI includes performance comparisons and visual indicators to help users quickly understand whether performance is improving or declining.
The revenue and spend chart allows users to compare:
- Advertising spend.
- Revenue generated.
- ROAS trends.
Users can switch between revenue and ROAS views to analyze campaign efficiency from different perspectives.
MarketMind AI breaks down performance by advertising platform, including:
- Google Ads.
- Meta Ads.
- Snapchat Ads.
The platform attribution view helps users understand where their budget is being spent and which channel is responsible for attributed sales.
The dashboard compares advertising spend and revenue across platforms, allowing users to identify:
- The most efficient platform.
- Platforms with high spend but low revenue.
- Platforms with strong revenue contribution.
- Opportunities for budget reallocation.
The CPA trend chart displays changes in cost per acquisition over time. This helps marketing teams identify:
- Increasing acquisition costs.
- Improvements in campaign efficiency.
- Sudden performance changes.
- Potential audience saturation or creative fatigue.
The Campaign Hub is the central area for managing campaigns and their related advertising entities.
Users can:
- Create campaigns.
- Edit campaign details.
- Delete campaigns.
- Enable or disable campaigns.
- Search campaigns.
- Filter campaigns by advertising platform.
- View campaign status.
- View synchronization status.
- Open detailed campaign views.
Campaign listings include important information such as:
- Campaign name.
- Platform.
- Campaign status.
- Daily spend.
- Revenue.
- ROAS.
- CTR.
Each campaign can contain multiple ad sets. Users can:
- Create ad sets.
- Edit ad sets.
- Delete ad sets.
- Toggle ad set status.
- Configure targeting settings.
- View related ads.
Users can manage individual advertisements by:
- Creating ads.
- Editing ads.
- Deleting ads.
- Enabling or disabling ads.
- Resubmitting ads.
- Recording ad-level performance metrics.
- Viewing platform-specific creative information.
The system supports platform-specific ad structures for Google, Meta, and Snapchat.
Campaign managers can record daily performance logs, update existing logs, and remove outdated records. Daily logs provide a historical view of campaign activity and make it easier to track changes over time.
The Campaign Hub includes:
- Search by campaign name.
- Filter by platform.
- Status badges.
- Synchronization indicators.
- Detailed campaign navigation.
- Confirmation dialogs for destructive actions.
The AI Insights module detects unusual campaign behavior and provides actionable recommendations.
The system analyzes campaign data to detect:
- Sudden drops in ROAS.
- Unusual increases in CPA.
- Unexpected changes in spend.
- Declining CTR.
- Performance instability.
- Campaigns operating outside expected ranges.
Alerts are organized into severity levels:
- Critical.
- Warning.
- Informational.
This allows users to prioritize the most important problems first.
Where available, each alert includes an AI-generated recommendation describing:
- What happened.
- Which campaign is affected.
- Why the issue may have occurred.
- What action should be considered.
- The category of the recommended action.
Users can:
- View all alerts.
- Filter alerts by severity.
- Refresh the analysis engine.
- Review the last analysis time.
- Open an alert directly in the AI Advisor for deeper investigation.
The AI Advisor provides a conversational interface for analyzing marketing performance.
Users can ask natural-language questions such as:
- Why did my ROAS drop last week?
- Which campaign should I pause?
- Which platform is performing best?
- Summarize this month's performance.
- How can I reduce CPA?
- Why are conversions declining?
- Which campaigns deserve more budget?
The AI Advisor supports:
- Natural-language campaign questions.
- Campaign performance analysis.
- Cross-channel comparisons.
- Root-cause investigation.
- Recommendation requests.
- Imported campaign analysis.
- Conversation history.
- Restoring previous chat sessions.
- Starting a new conversation.
The advisor is connected to campaign context and is designed to provide answers without requiring users to write SQL queries or manually interpret complex spreadsheets.
Users can:
- View previous conversations.
- Restore an earlier chat session.
- Start a new chat.
- Continue discussions using existing campaign context.
The Content Generation Studio helps marketers create complete advertising packages from a product image and campaign requirements.
The studio uses a guided workflow:
- Upload a product image.
- Analyze the image with AI.
- Select the target advertising platform.
- Answer campaign-specific questions.
- Generate the final content package.
The system analyzes uploaded product images and extracts information such as:
- Product name.
- Product category.
- Image quality.
- Visual style or vibe.
- Dominant colors.
- Potential target audience.
Generated content can be tailored for platforms such as:
- Meta Ads.
- Google Ads.
- Snapchat Ads.
- Email marketing.
The studio can generate:
- Advertisement copy.
- Campaign hooks.
- Social media captions.
- Video hooks.
- Video scripts.
- Email subject line variations.
- Keywords.
- Platform-specific creative suggestions.
- Image banners and layouts.
Users can save generated content to a personal library and:
- Review previous generations.
- Reuse successful content.
- Delete outdated generations.
- Compare generated variations.
The Content Studio can be opened in the context of a specific campaign, allowing generated content to be associated with that campaign and platform.
The Campaign Simulator allows users to test marketing decisions before applying them to active campaigns.
Users can evaluate possible changes such as:
- Increasing or decreasing a campaign budget.
- Testing campaign strategy changes.
- Comparing possible campaign scenarios.
- Estimating future revenue.
- Estimating future ROAS.
- Reviewing potential spend changes.
After running a simulation, the system displays:
- Historical performance.
- Projected performance.
- Projected spend.
- Projected ROAS.
- Projected revenue.
- Confidence ranges.
- Comparison statistics.
The simulator provides an explanation of the expected result in plain English. It can describe:
- Budget saturation.
- Historical campaign behavior.
- Expected changes in efficiency.
- Potential revenue impact.
- Risks associated with the proposed change.
- Whether a smaller test may be preferable.
Users can:
- Save scenarios.
- Compare one scenario with another.
- Review scenario history.
- Delete saved scenarios.
- Apply a proposed change after confirmation.
The simulator is designed to support safer decision-making by allowing users to evaluate changes before modifying live campaign settings.
The Data Ingestion Engine allows users to import historical advertising data from CSV files.
CSV files can be uploaded for:
- Google Ads.
- Meta Ads.
- Snapchat Ads.
Users can:
- Drag and drop a file.
- Browse for a file.
- Select the target advertising platform.
- Upload CSV or TXT data files.
- Review processing results.
The ingestion engine validates uploaded files and reports missing required headers when the file format is invalid.
After successful processing, the system displays:
- Number of campaigns imported.
- Number of ad sets imported.
- Number of analytics rows processed.
- Upload status.
- Processing history.
Imported campaigns can be reviewed using:
- Total spend.
- Average ROAS.
- Total clicks.
- Total conversions.
- Campaign date range.
- Platform information.
Users can send imported campaign context directly to the AI Advisor for analysis and recommendations.
The upload history table records:
- Original file name.
- Advertising platform.
- Upload status.
- Number of processed rows.
- Upload date and time.
The Reports Export module creates professional PDF reports from campaign data.
Designed for executives and clients. Includes:
- KPI scorecard.
- Total spend.
- Conversions.
- CPA.
- ROAS.
- AI-generated executive commentary.
Designed for CMOs and marketing strategists. Includes:
- Aggregated campaign data.
- Executive narrative.
- Audience behavior insights.
- Creative performance analysis.
- Budget intelligence.
- Consumer behavioral archetypes.
Designed for campaign managers and media buyers. Includes:
- Channel performance tables.
- Audience performance tables.
- Ad set performance tables.
- Ad creative performance tables.
- AI-generated key learnings.
- Action items.
A comprehensive report containing:
- Campaign data.
- Performance trends.
- Executive summary.
- Audience behavior insights.
- Creative performance insights.
- Budget intelligence.
- Consumer archetypes.
- Key learnings.
- Strategic recommendations.
Report generation runs through a background job workflow:
- Select a report type.
- Select a campaign.
- Review the report sections.
- Start report generation.
- Monitor progress.
- Review completed sections.
- Download the generated PDF.
Previously generated reports can be:
- Viewed in report history.
- Downloaded again.
- Reviewed by campaign.
- Identified by report type and creation date.
- Checked for file size and generation status.
MarketMind AI provides a centralized integration area for managing advertising accounts.
The application includes integration support for:
- Google Ads.
- Meta Ads.
- Snapchat Ads.
Users can connect advertising accounts by providing platform-specific credentials and configuration information.
Depending on the platform, the integration may require:
- Account name.
- Developer token.
- Application ID.
- Application secret.
- Access token.
- Advertising account ID.
- Client ID.
Users can:
- View connected accounts.
- Add an advertising account.
- Review account identifiers.
- Disconnect an account.
- Manage sandbox or API configuration.
When an account is disconnected, campaign synchronization and publishing capabilities for that account are disabled.
MarketMind AI includes a complete authentication system for protecting user accounts.
The platform supports:
- User registration.
- User login.
- User logout.
- Email verification.
- Password reset.
- Two-factor authentication.
- Two-factor challenge verification.
- Protected API routes.
- Session-based authentication.
- Sanctum authentication.
New accounts can be required to verify their email address before accessing protected functionality.
Users can request a password reset and complete the reset process using a secure reset flow.
Users can enable two-factor authentication using an authenticator application such as Google Authenticator.
The system supports:
- Enabling two-factor authentication.
- Generating setup information.
- Verifying authentication codes.
- Completing two-factor login challenges.
- Disabling two-factor authentication.
The profile area provides tools for managing account identity and security settings.
Users can update their profile information and manage account details.
Users can:
- Change their password.
- Update password credentials.
- Receive validation feedback.
- Protect sensitive session operations with password confirmation.
Users can:
- View active sessions.
- Identify connected devices.
- Log out a specific device.
- Log out other devices.
- Review account activity.
This helps users maintain control over their account across multiple browsers and devices.
MarketMind AI includes subscription and payment functionality powered by Stripe.
Users can:
- View available plans.
- Select a paid plan.
- Start a secure checkout flow.
- Enter payment details using Stripe Elements.
- Receive payment status feedback.
- View successful payment confirmation.
The billing process works as follows:
- User selects a plan.
- The backend creates a Stripe PaymentIntent.
- The frontend receives the client secret.
- Stripe Elements renders the secure checkout form.
- Stripe processes the payment.
- The application displays the payment result.
Payment details are handled through Stripe rather than stored directly by the application.
- React 19.
- Vite.
- React Router.
- Axios.
- Tailwind CSS.
- Framer Motion.
- Recharts.
- Heroicons.
- Stripe React SDK.
- jsPDF.
- jsPDF AutoTable.
- React Datepicker.
- Inter font.
- PHP 8.3.
- Laravel 13.
- Laravel Sanctum.
- Laravel Fortify.
- Laravel Socialite.
- Laravel Horizon.
- Laravel Queue.
- Laravel Tinker.
- Stripe PHP SDK.
- DomPDF.
- PHPUnit.
- SQLite for local development by default.
- MySQL-compatible database support.
- Database-backed queues.
- Database-backed sessions.
- Database-backed cache.
- Laravel Horizon for queue monitoring.
- Pinecone integration for campaign context and semantic search.
- Google, Meta, and Snapchat advertising platform adapters.
MarketMind AI is organized into a modern frontend and backend architecture.
Frontend
React + Vite
|
| Axios API requests
v
Backend
Laravel API
|
+-- Authentication and user management
+-- Campaign management
+-- Data ingestion
+-- AI insights
+-- AI advisor
+-- Content generation
+-- Reports and PDF generation
+-- Platform integrations
+-- Billing and Stripe
+-- Queue jobs
|
+-- Database
+-- Pinecone context storage
+-- Advertising platform APIs
+-- Stripe