Existing advertising campaign tools are either too expensive or too complex. Most small agencies and freelancers still manage campaigns in spreadsheets. There is no middle ground.
So I Built AdCampaignManager — A Full-Stack Advertising Campaign Management Platform That Combines Real-Time Data With Generative AI.
Here Is The Complete Breakdown Of How It Works.
━━━━━━━━━━━━━━━━━━
🛠️ The Tech Stack
- Frontend - React.Js Plus Vite Plus Tailwind CSS v4
- Backend - Node.Js Plus Express.Js
- Database - MongoDB Plus Mongoose
- Real-Time - Socket.IO
- AI Layer - Groq LLM openai/gpt-oss-120b
- Image Upload - Cloudinary Plus Multer
- Email - Nodemailer
- Scheduled Tasks - Node-Cron
- Authentication - JWT Plus Bcrypt Plus OTP
━━━━━━━━━━━━━━━━━━
🎯 The 10 Core Modules
- Dashboard
Real-Time KPI Cards Showing Impressions Clicks Conversions Revenue CTR CPC ROI And CVR. All Data Fetched Live From MongoDB Aggregation Pipelines.
- Authentication
Register Login Email OTP Verification 2FA Password Reset Session Management. JWT With Access Plus Refresh Tokens Stored In localStorage.
- Campaign Management
Full CRUD With Status Lifecycle Draft To Scheduled To Running To Paused To Completed To Cancelled. Duplicate Compare Side-By-Side Creative Upload Via Cloudinary.
- Audience Management
Age Range Gender 50 Countries 50 Cities 50 Interests 50 Languages And Device Targeting. Overlap Detection Between Segments.
- Analytics And Insights
Real-Time KPIs Engagement Heatmap Hour By Day Traffic Sources Funnel Analysis Campaign Leaderboard.
- Subscription Plans
12 Plus Premium Tiers Subscribe Auto-Renew Corporate Plans Usage Analytics.
- Reviews And Moderation
5-Star Ratings Sentiment Badges Photo Uploads Admin Approval Workflow.
- Team Collaboration
Real-Time Chat Via Socket.IO Kanban Boards Member Roles Activity Feed.
- Support Tickets
Categories Priorities Reply Threads Internal Notes Knowledge Base.
- AI Insights Dashboard
Platform-Wide KPIs Anomaly Alerts AI Narratives.
━━━━━━━━━━━━━━━━━━
🤖 The Generative AI Layer
Every Module Has Its Own Dedicated AI Service Powered By Groq LLM openai/gpt-oss-120b.
Here Are The 10 AI Services
Analytics AI
Narrate Insights Detect Anomalies Forecast Revenue For 30 60 90 Days Generate Report Advise KPI Explain Trend Reallocate Budget Analyze Creative.
Campaign AI
Write Copy Suggest Goal Optimize Budget Generate Name Quality Check Suggest Schedule.
Audience AI
Recommend Audience Suggest Interests Estimate Reach Optimize Demographics Build Lookalike Resolve Overlap.
Plan AI
Recommend Plan Write Benefits Advise Upgrade Detect Renewal Risk Suggest Pricing Build Corporate Plan.
Review AI
Sentiment Analysis Fake Review Detection Summarize Reviews Draft Admin Reply Moderate Photo Extract Highlights.
Insights AI
Narrate Platform Detect Anomalies Forecast Revenue Generate Report Advise KPI Explain Trend.
Support AI
Classify Ticket Draft Reply Detect Duplicate Suggest FAQ Predict Resolution Time Auto-Write FAQ.
Team AI
Summarize Chat Auto-Assign Tasks Find Meeting Time Productivity Insights Suggest File Tags Recommend Lead.
━━━━━━━━━━━━━━━━━━
💡 Key Engineering Decisions
- JSON Mode
Every AI Prompt Forces The LLM To Return Valid JSON. This Prevents Parsing Errors And Broken UI. Without JSON Mode The AI Sometimes Returns Markdown Which Crashes The Frontend Parser.
- cleanValue Helper
The AI Sometimes Returns Placeholder Values Like N/A Or A Hyphen Or Empty Strings. This Helper Sanitizes Them Before They Reach The Frontend.
- Post-Processing
After Every AI Response Arrays Are Filtered To Remove Invalid Values. Generation Plus Cleanup Is The Reliable Pattern.
- Real-Time Sync
Socket.IO Room-Based Subscriptions For Team Chat. Each Client Joins Only The Rooms It Needs Using team Colon teamId Format. This Keeps Bandwidth Low And Updates Instant.
- Scheduled Automation
Node-Cron Runs Two Jobs. Every Minute It Simulates Running Campaigns To Generate Realistic Impressions Clicks Conversions Spend And Revenue. Daily At Midnight It Aggregates Previous Day Analytics Into A Single Snapshot Document For Fast 30 60 90 Day Queries.
━━━━━━━━━━━━━━━━━━
🔐 Security Architecture
- JWT Authentication With Access And Refresh Tokens
- Email OTP Verification 6 Digits 1 Min Expiry
- Optional 2FA Via Email
- Password Reset Via OTP And Short-Lived JWT
- Rate Limiting 500 Requests Per 15 Min Global 50 Requests Per 15 Min Auth
- Helmet.Js Security Headers
- CORS With Credentials
- Cloudinary File Type Validation
- Bcrypt Password Hashing 10 Salt Rounds
- Environment Variables For All Secrets
━━━━━━━━━━━━━━━━━━
🎨 UI Design Philosophy
- Glassmorphism On Every Card Using backdrop-blur-xl border-2 border-white/10 rounded-3xl
- Green Gradient Theme from-black via-[#021d0f] to-black Across All Pages
- Uppercase Bold Typography With tracking-[0.2em]
- Custom Dropdowns With Animated Chevrons
- Modal Portals With Backdrop Blur
- Toast Notifications With Color-Coded Types
- Corner Brackets On Every Card
- Floating Icon Animations
- Staggered Fade-In For Table Rows
- Fully Responsive Design
━━━━━━━━━━━━━━━━━━
💡 Key Challenges And Learnings
Challenge 1 — AI Output Reliability
The LLM Sometimes Returns Invalid JSON Or Placeholder Values. This Was Fixed With A Three-Layer Approach. First Force JSON Mode At The API Level. Second Sanitize Every Value With The cleanValue Helper. Third Filter Arrays During Post-Processing.
Challenge 2 — Real-Time Team Chat
The Team Members Needed Live Chat Without Refresh. This Was Solved With Socket.IO Room-Based Subscriptions. Each Client Joins Only The Rooms It Needs.
Challenge 3 — Fast Analytics Queries
The Analytics Collection Grew Huge. This Was Solved With Daily Snapshot Cron Job That Aggregates Data Into A Lightweight Collection For Fast Queries.
Challenge 4 — Multi-Role Permission
Admin And User Roles Need Different Access Levels. This Was Solved With owner Field Check Plus isAdmin Boolean Plus Backend authorize Middleware.
Challenge 5 — Campaign Lifecycle
Campaigns Need To Move Through Multiple States. This Was Solved With Auto Transitions From Draft To Scheduled To Running To Paused To Completed To Cancelled.
Challenge 6 — Image Uploads In Serverless
Local Disk Storage Breaks In Serverless Deployments. This Was Solved With Cloudinary Streaming API. The File Buffer Goes Directly To CDN.
━━━━━━━━━━━━━━━━━━
🎯 What Comes Next
I Am Currently Working On Adding Voice-Based AI Assistant To AdCampaignManager. The Plan Is To Let Users Speak Commands Like Create A New Campaign For Sneakers With 5000 Rupees Daily Budget And The AI Will Auto-Fill Everything.
Other Planned Features Include
- Real-Time Collaboration With Cursor Tracking
- Mobile App Using React Native
- Public API For Third-Party Developers
- Advanced Predictive Analytics Dashboard
━━━━━━━━━━━━━━━━━━
📌 Final Thoughts
Building AdCampaignManager Taught Me That Production AI Is Not Just About Calling An LLM. It Is About Prompt Engineering Error Handling Post-Processing And Delivering Clean Data To Users.
The Biggest Lesson Was That Reliability Matters More Than Cleverness. A Simple JSON Mode Plus Cleanup Logic Beats An Elaborate Prompt That Sometimes Fails.
The Second Lesson Was That Real-Time Features Need Careful Architecture. Broadcasting To All Clients Kills Performance. Room-Based Subscriptions Are The Way.
━━━━━━━━━━━━━━━━━━
Interested In The Full Source Code Or Getting This Project For Your Portfolio?
🌐 https://www.theprojectstack.com/
Happy To Answer Any Questions About The Architecture Or AI Integration. Drop A Comment Below!
Top comments (0)