چۈشەندۈرۈش

Stop guessing which marketing channels deserve your time and budget. AI Marketing Roadmap analyzes your WordPress site and gives you a personalized, prioritized 6-month plan across SEO, paid ads, content, email, local search, and more — generated in under 10 minutes, free.

You answer a few short questions about your business. The plugin reads your site (pages, plugins, WooCommerce products, contact info, SEO data) so the AI never asks things it can already see. You get back a month-by-month roadmap showing exactly which channels to launch, in what order, and why.

No signup required. No API key required. Free forever.

How it works

Activate the plugin and click Roadmap in your admin sidebar
The plugin auto-analyzes your site (pages, plugins, products, contact info)
A built-in AI assistant asks 5-10 short questions about your business
You get a complete roadmap: which channels to launch (Google Business Profile, SEO, Meta Ads, email, etc.), in what month, with explanations
Export to PDF, CSV, Google Sheets, or Notion

What you get

A prioritized deployment plan — 15-30 channels ranked for your specific business model
Month-by-month timeline based on your team capacity and budget
Industry-specific recommendations for 50+ verticals
KPI tracker showing what to measure each month
Service-area map for local businesses
«This week’s focus» dashboard widget — keeps the plan in front of you, not buried in a menu
Exports to PDF, CSV, Google Sheets, Notion, and Email
Conversation + roadmap saved so you can refine later

Especially good for local service businesses

If you’re a painter, plumber, dentist, attorney, contractor, cleaner, or any business that serves customers in a defined geographic area, this plugin is tuned for you. The roadmap leads with Google Business Profile optimization, service-area SEO, review-velocity tactics, and local directory placement — the channels that actually move the needle for service businesses, in the order they should be tackled. A built-in service-area map visualizes your coverage and identifies geographic gaps.

Use cases

Local service businesses (painters, plumbers, dentists, attorneys) — Google-Business-Profile-first plan tuned to your service area
WooCommerce / DTC — Meta Ads + Google Shopping + email lifecycle roadmap
Personal brands & coaches — content-first plan with newsletter, podcast guesting, speaking
SaaS — SEO + LinkedIn + integrations playbook
Nonprofits — donor + volunteer acquisition channels

Under the hood: the Hub & Spoke framework

The roadmap is generated using Ad-Apt’s Hub & Spoke model — your website is the hub (the one channel you fully own) and every marketing channel is a spoke that drives traffic back to it. The AI identifies which spokes matter for your business model and prioritizes by impact, cost, and time-to-value. You don’t need to know the framework to use the plugin — it just shapes how the AI thinks.

Built by Ad-Apt, a Portland-based performance marketing agency.

External services

This plugin relies on the following third-party services. Each is documented below with what is sent, when, and why.

1. api.ad-apt.com (Ad-Apt hosted AI service)

The plugin sends data to api.ad-apt.com, a service operated by Ad-Apt, to generate your marketing roadmap.

What is sent:
* Auto-detected site information (site name, URL, page titles, navigation, plugin signals, WooCommerce category names) — sent once on first run, used by the AI to generate a starting plan
* Chat messages you write to the AI assistant — sent on each conversation turn
* An anonymous install ID (random UUID generated on first activation, never tied to personal info)

Why it’s sent: the AI roadmap is generated by Anthropic’s Claude API. Holding the API key on our server (rather than asking each user to bring their own) lets us offer the plugin for free.

When it’s sent: every time you send a message in the chat. The plugin does not contact our service when not in use.

Service: api.ad-apt.com (Cloudflare Worker proxy Anthropic Claude API)
Terms: https://ad-apt.com/terms
Privacy: https://ad-apt.com/privacy

If you submit your email through the optional «Email me my roadmap» form, your email is also sent to api.ad-apt.com and stored so we can email you the roadmap and (if opted in) marketing tips. You can unsubscribe at any time.

2. OpenStreetMap Nominatim (geocoding for the service-area map)

If your roadmap includes a service-area map (local-business roadmaps only), the plugin’s frontend script geocodes each service-area name (e.g. «Portland, OR») so it can be plotted on the map.

What is sent: the city/area name (and, when available, the business address) from your saved roadmap inputs — sent only as a search query to the Nominatim public geocoding API.

When it’s sent: only when you open a finished roadmap that contains a service-area list. No data is sent on plugin activation, on the chat screen, or for non-local roadmaps.

Why it’s sent: to convert each named area into latitude/longitude so the Leaflet map can render markers.

Service: Nominatim (public geocoding API operated by the OpenStreetMap Foundation)
Endpoint: https://nominatim.openstreetmap.org/search
Terms / Usage Policy: https://operations.osmfoundation.org/policies/nominatim/
Privacy: https://osmfoundation.org/wiki/Privacy_Policy

ئېكران كەسمىسى

Your finished roadmap — the channels to launch, in priority order
Month-by-month timeline — what goes live when
Service-area map and industry-specific intel for your vertical
«This Week’s Marketing Focus» dashboard widget — keeps the plan in front of you
Chat with the AI to refine your roadmap on the fly
Free exports: PDF, CSV, Google Sheets, Notion, Email — no email gate

ئورنىتىش

Upload the plugin files to /wp-content/plugins/ad-apt-roadmap/, or install through Plugins Add New
Activate through the Plugins menu in WordPress
Click Roadmap in the admin sidebar
Walk through the chat — the AI will guide you

FAQ

Do I need an API key?: No. The plugin uses a free, hosted Ad-Apt service. No keys, no setup.
Is it really free?: Yes. Free forever for the core roadmap generator. We may offer paid premium features later (cloud sync, advanced channels, agentic execution), but the roadmap itself stays free.
How accurate is the AI?: The AI is Claude (Anthropic), a state-of-the-art language model trained by humans. It works from a curated framework Ad-Apt built from years of agency work. The roadmap is a starting strategy — review it with a marketing person before pouring money in.
Can I edit the roadmap after it’s generated?: You can refine it by chatting with the AI («change my budget to bootstrapped», «remove TikTok from the plan», etc.) and it’ll regenerate.
What data is sent off my site?: See the External services section above. Short version: site metadata + your chat messages, sent to api.ad-apt.com to generate the roadmap. No content (post bodies), no personal data of your users, no analytics.
Can I delete my data?: Yes. Click «Start over» in the chat to clear the local roadmap and conversation. To request deletion of data on api.ad-apt.com (your install ID and any email you submitted), contact privacy@ad-apt.com.
How do I uninstall cleanly?: Deactivating + deleting the plugin removes all stored options and conversation history from your site automatically.

باھالاشلار

بۇ قىستۇرمىغا تېخى باھا يېزىلمىدى.

تۆھپىكار ۋە ئىجادكار

«Ad-Apt AI Marketing Roadmap» كودى ئوچۇق يۇمشاق دېتال. تۆۋەندىكى كىشىلەر بۇ قىستۇرمىغا تۆھپە قوشقان.

adaptmarketing

«Ad-Apt AI Marketing Roadmap» نى تىلىڭىزغا تەرجىمە قىلىڭ

ئىجادىيەتكە قىزىقامسىز؟

كودقا كۆز يۈگۈرتۈپ، SVN خەزىنە تەكشۈرۈپ ياكى RSSئارقىلىق ئىجادىيەت خاتىرىسىگە مۇشتەرى بولغىلى بولىدۇ.

ئۆزگىرىش خاتىرىسى

1.11.1

Plugin Check / wp.org review pass — moved inline <style> and <script> from templates/connections.php into properly enqueued assets (assets/css/connections.css and assets/js/connections-debug.js)
PHP-side state for the Connections debug page is now passed to JS via wp_localize_script (adaptRMConn), so admin-ajax URL and nonce are JSON-encoded by core instead of being echoed into a JavaScript string
Prefixed template-scope variables in templates/connections.php ($account/$paired/$ga4 $adapt_account/$adapt_paired/$adapt_ga4) to satisfy WordPress.NamingConventions.PrefixAllGlobals
Replaced wp_redirect() in the Google OAuth launcher with wp_safe_redirect() and a scoped allowed_redirect_hosts filter for the upstream consent URL
Added explicit phpcs:ignore comments documenting that ajax inputs are nonce-verified up-stack and that JSON payloads are sanitized after json_decode (sanitize_messages / sanitize_recursive)
No user-visible changes

1.11.0

Renamed plugin to «Ad-Apt AI Marketing Roadmap» (slug: ad-apt-ai-marketing-roadmap) — distinctive Ad-Apt identifier moved to the front of the name
Security: incoming chat-history JSON ($_POST[›messages‹]) and saved roadmap JSON ($_POST[›data‹]) are now recursively sanitized after json_decode; messages normalized to {role, content} with sanitize_key + sanitize_textarea_field
Documented OpenStreetMap Nominatim as a third-party service used by the service-area map, with terms and privacy links
New: Connections panel inline in the Measurement section of your roadmap — pair your Ad-Apt account, connect Google, and set up GA4 in three clicks without leaving the page
GA4 setup is fully agentic: creates a property in your own Google account (you keep ownership), picks the right industry category from your roadmap, and stores the measurement ID for the upcoming gtag injector
Debug Connections submenu hidden by default (now only shown when WP_DEBUG is on)

1.10.2

Plugin Check pass — text domain aligned with wp.org slug, output escaping inlined, $_POST handling switched to wp_unslash, removed deprecated load_plugin_textdomain call, prefixed uninstall globals
No user-visible changes

1.10.1

Plugin-side daily message cap (30/day per install) with friendly UX before users hit the server limit
Defense-in-depth alongside the hosted Worker’s per-install + global daily caps

1.10.0

New: «This Week’s Marketing Focus» dashboard widget — surfaces the current month’s channels on your WP dashboard so the roadmap stays in front of you
New: site-specific quick-scan findings — the AI now opens with a concrete gap (missing analytics, no abandoned-cart recovery, stale blog, no local SEO signal, etc.) instead of restating what you already see
Public plugin name updated to «AI Marketing Roadmap — by Ad-Apt» for keyword discovery (slug unchanged)
Removed sticky in-roadmap email signup; kept the dismissable post-roadmap card only (less funnel-y)
Removed dead export modal HTML/JS (exports already run inline)
Local-service positioning spotlight added to readme

1.9.0

Self-hosted Google Fonts (Outfit, Source Sans 3, Instrument Serif, JetBrains Mono) — no more third-party CDN, GDPR-friendly
Bundled Leaflet 1.9.4 locally — no more cdnjs reference
Added load_plugin_textdomain() for proper i18n support
Synced Stable tag with plugin version

1.8.2

Identity prompt update — assistant introduces as Ad-Apt Roadmap, no Claude branding
Removed «Powered by Claude» footer label

1.8.1

Leaflet invalidateSize() fix — map renders correctly when service-area panel opens after roadmap generation

1.8.0

Claude-like chat UI refresh — message bubbles, typing indicator, smoother scroll behavior

1.7.0

Email opt-in form posts to Worker (/roadmap-chat/signup) and stores in D1 roadmap_email_signups
Honors WordPress admin_email default; one-click consent

1.6.0

Server-side rate limiting + analytics via D1 (roadmap_chat_usage table)
Anonymous install ID (UUID) generated on first activation

1.5.5

Removed promotional CTA from end of roadmap
Added optional email opt-in card with newsletter signup
Added privacy policy link in chat footer

1.5.4

Map: filter out region-level geocodes (states, regions) — only show city-level markers
Map: anchor outlier filter on first listed area, not centroid
Expanded vague-terms blocklist (Pacific Northwest, Midwest, etc.)

1.5.3

PDF export: fixed blank output (was hiding the parent container)
Map: more lenient filter, accepts any city-level geocode

1.5.2

PDF export: print stylesheet improvements; correctly disables animations during snapshot
Better print color preservation for dark CTA card

1.5.1

Map: smart zoom — tight on single city, bounded fit for multiple
Map: hide entirely when all geocodes fail (no more world view)

1.5.0

Working exports: PDF, CSV, Google Sheets, Notion (markdown copy), Email (mailto)
Removed modal-based export flow — exports happen instantly with feedback
Fixed CTA button text visibility against WP admin link colors

1.4.0

MAX_TOKENS bumped to 8192 — fixes truncated roadmap JSON
Server-side conversation persistence — refresh-safe
Truncation-safe sanitizer

1.3.0

Robust JSON parser handles multiple Claude output formats
Defensive client-side filter strips JSON dumps from chat
Added circular progress visualization

1.2.0

Chat-first layout with roadmap as expandable side drawer
Plugin container fits properly in WP admin
Fits responsive screens

1.1.0

Brand alignment with ad-apt.com (Outfit, Source Sans 3, Instrument Serif, brand color tokens)
Defensive WP admin CSS resets

1.0.0

Initial release