AI Ads Planner (Google & Meta)

What you get

Taken from this product's own README (included in the download). A PHPGuru-developed product.

Included

• Dashboard: spend, leads, cost per lead, ROAS, revenue with change versus the prior period; 7/14/30/90-day and platform filters; daily performance chart; top campaigns; spend by platform; recent activity; dark and light themes; works on phones
• Report importer for Google Ads and Meta Ads Manager CSV exports (also Excel-style UTF-16 files) with automatic column detection and a mapping step; simple template; sample data for three months and seven campaigns
• Optional Google Ads connection: sign in with Google (OAuth 2.0), account picker, read-only sync of the last 30–365 days, Refresh data button, clear error messages for access-level and sign-in problems; no client library needed
• Campaigns list with filters, sorting, totals and CSV export; campaign detail page with daily chart and table; edit name, type, status and budget
• AI analysis with summary and recommendations (pause, resume, raise / lower / shift budget, negative keywords, new ad variant, landing page, tracking, audience); approvals workflow (pending / approved / done / rejected); activity log
• Brief form with validation and sensible defaults per account
• Draft Google Search plan: campaigns, ad groups, keywords (exact, phrase, broad), negatives, responsive search ads, sitelinks, callouts, budget split
• Draft Meta plan: campaigns, ad sets (countries, cities, ages, gender, interests, optimisation goal), ads with image briefs
• On-screen review with character counts and warnings; regenerate with feedback
• Exports: Google Ads Editor CSV, Meta Ads Manager import CSV, Markdown brief
• Settings: API key stored encrypted, model choice (Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 or any model id), Facebook Page ID, default currency, locations and language, connection test
• Illustrated guide (docs/guide.html): setup, Google Cloud connection, report import, dashboard, AI analysis and approvals, planner, Google Ads Editor and Meta Ads Manager imports, building a Meta campaign step by step, boosting an Instagram post; sample report files
• CSRF protection on every form, prepared statements, login lockout after repeated failures, upgrade script for 1.0 installations
• Plain PHP + cURL, Bootstrap 5 and Chart.js from a CDN, no Composer or extra libraries

What it is not

It does not change anything in your ad accounts: the optional Google Ads connection only reads reports (Google offers a single API permission; this app uses it for reading only), Meta is read from the report you export, and it cannot pause, enable or change a campaign for you — every recommendation is applied by you, by hand. The Google Ads connection depends on Google granting your own Cloud project a production access level (Explorer or Basic); until then, use the report import. There is no Meta API connection in this version. It is not a replacement for checking ad policies, prices and claims; plans are drafts written from your brief and recommendations are suggestions computed from the numbers you imported, and you are responsible for what goes live and what you change. Meta data is not fetched automatically: you import a fresh Ads Manager report when you want it updated; Google Ads data refreshes when you click Refresh data. It does not create images and does not include a free AI service: generation and analysis are billed on your own Anthropic account. The Meta import file follows Meta's 2026 bulk-import template and the report importer recognises the 2026 column names; Google and Meta change these from time to time, so compare with a fresh template and correct the column mapping when asked.

Requirements & testing

PHP 7.4+ (tested on PHP 8.5) with the curl, openssl, json and mbstring extensions, MySQL 5.7+ or MariaDB 10+ (tested on MySQL 8.0), and outgoing HTTPS access to api.anthropic.com. Your browser needs internet access for Bootstrap and Chart.js from the CDN. For the Google Ads connection: a free Google Cloud project with the Google Ads API enabled and an OAuth client; outgoing HTTPS to accounts.google.com, oauth2.googleapis.com and googleads.googleapis.com. For the planner imports: Google Ads Editor (free desktop app) and a Meta Ads Manager account.

In the download

Full PHP source, database schema (sql/schema.sql), README with installation steps.

Installation (11 steps)

Install XAMPP (or use any PHP hosting), start Apache and MySQL, and copy this folder into htdocs (for example htdocs/ads-planner) → Create a new MySQL database called ai_ads_planner in phpMyAdmin → Import sql/schema.sql into that database → Open config.php and set DB_HOST, DB_NAME, DB_USER, DB_PASS (on XAMPP the defaults — localhost, root, empty password — usually work) → Open http://localhost/ads-planner/login.php, log in, and change the password straight away → Open Settings, paste your Anthropic API key and click "Test connection". Add your Facebook Page ID if you will use the Meta planner → Open Import reports and upload a campaign report from Google Ads or Ads Manager — or click "Load sample data" to try the dashboard first → Optional: open Integrations and connect Google Ads (a free Google Cloud project with the Google Ads API enabled; the guide walks through it) so the dashboard refreshes itself → Copy the new files over your installation, keeping your config.php → Coming from 1.0: import sql/upgrade_1.1.sql into your existing database once (it only adds the new tables; your plans and settings are kept). Coming from 1.1: no database change → Log in — the Dashboard, Campaigns, Import reports, Integrations, AI analysis, Approvals and Activity pages appear in the menu. Prefer us to do it? Add installation at checkout.

Support & licence

Email support is included with your purchase — reply with your payment ID and what you're seeing, and we'll help you get it running. Licence terms: Regular vs Agency.