Help
How Promvia works
Plain-English answers to the common questions. Still stuck? Email support@promvia.app.
What is Promvia?
Promvia shows how much traffic and revenue AI assistants send to your website — and whether AI recommends you when people ask about your space. It's the analytics your other tools can't give you, because they bury AI visits as “direct”.
What is GEO (Generative Engine Optimization)?
GEO is optimizing your brand so AI assistants — ChatGPT, Perplexity, Gemini, Google AI Overviews, Copilot and Claude — recommend and cite you when people ask buying questions in your space. It's like SEO, but for AI answers instead of the ten blue links. Promvia tracks whether AI names you, shows which competitors are cited instead and what evidence differs, and gives you the exact fixes.
How is GEO different from SEO?
SEO targets a rank in a list of links; GEO is about the signals associated with appearing inside a generated answer — and measuring whether you do. They share fundamentals — crawlable, well-structured, trustworthy pages — but GEO also cares about being cited by the third-party sources AI trusts, being described accurately, and directly answering buyer questions. Promvia measures both your technical readiness and whether AI actually recommends you.
How do I get recommended by AI?
Run a GEO audit and citation check in Promvia, then work the Fix list: make your site crawlable and well-structured, publish clear comparison and FAQ pages that answer the exact questions buyers ask, earn mentions on the third-party sources AI already cites, and keep your brand described consistently everywhere. Promvia hands you the specific fixes and content briefs for each.
How do I install it?
On your Sites page, each site has a one-line snippet. Copy it and paste it into your website's HTML header — every site builder (Shopify, WordPress, Webflow, Wix…) has a "custom code / header" box for exactly this. Once it's live, visits start appearing within minutes, and the site card shows "✓ Receiving data".
How does the revenue number work?
On your checkout or thank-you page, call window.aita.conversion('purchase', { value: 49.99 }) with the sale amount. Promvia links that sale back to the visit that brought the customer, so it can tell you "X in revenue is associated with AI referrals", not just clicks. (The older window.aita.conversion(49.99) still works — it's counted as a "purchase".) Pass the order id as well — window.aita.conversion('purchase', { value: 49.99, eventId: 'order-1001' }) — so a refreshed thank-you page counts once and two orders of the same amount count twice.
Can I track sign-ups and other goals, not just sales?
Yes — give each goal a name. Common ones: window.aita.conversion('add_to_cart'), window.aita.conversion('checkout_started') and window.aita.conversion('purchase', { value: 49.99 }) for stores; window.aita.conversion('signup'), window.aita.conversion('trial_start') and window.aita.conversion('demo_request') for SaaS and lead-gen; or window.aita.conversion('newsletter_signup') for email capture. Your dashboard's "Conversions by goal" panel then shows which goals your AI traffic drives — across the whole funnel, not just the final sale.
What do "Cited", "Mentioned" and "Not cited" mean?
On Questions & results you add the searches your customers ask AI. For each one: ◐ Mentioned means AI named your brand in its answer; ✓ Cited means it went further and linked your own URL as a source; ✗ Not cited means AI answered but didn't reference you (you'll see exactly who got cited instead). Getting mentioned is the first win; getting cited is the strongest.
What is the "How to get cited" advice?
It's GEO — Generative Engine Optimization, the AI-era version of SEO. When you're not cited for a question, Promvia looks at who AI did cite and gives you specific steps aimed at that gap — e.g. get mentioned in the Reddit threads or review sites AI is pulling from, or publish a clearer page than the competitor it cited.
Which AI assistants does Promvia track?
6 default answer surfaces: ChatGPT, Claude, Perplexity, Gemini, Google AI Overviews and Google AI Mode. On a paid plan you can add Grok as well. On a paid plan you choose which of them your account uses. Not measured yet: Microsoft Copilot. How each one is read is on How we measure.
Is my visitors' data private?
Promvia records which AI source sent a visit and which page they landed on — it does not intentionally collect names, emails, or personal details from your visitors, and it is built not to carry them (query strings are dropped, visitor ids are hashed) — the one thing it cannot police is a conversion goal key you define yourself, so keep personal data out of those. The snippet is lightweight and cookie-light.
How much does Promvia cost?
Four plans: Free forever (1 site, Perplexity checks, core analytics + GEO audit); Starter at €29/month (all 6 default engines on demand, 20 questions, trend checks every 3 days on 10 of them, a weekly auto-check on ChatGPT, Perplexity and Gemini by default — you choose the engines, and can run the low-cost ones daily — one GEO coaching plan a month); Pro at €119/month (up to 5 sites, 80 questions, every question checked daily on Perplexity, Gemini, AI Overviews and Google AI Mode with a weekly deep check on ChatGPT and Claude, GEO coaching on demand, content briefs, API and MCP); Agency at €449/month (up to 15 sites, 220 questions, checked the same way, white-label client reports included). White-label is also a €29/month add-on on Starter and Pro, so you do not have to jump to Agency just to put your own name on a client report. Every paid plan includes unlimited teammates. Paying yearly on Starter or Pro bills twelve months at the monthly price and holds that price for the year. Agency yearly is two months free. No credit card to start, and you can cancel anytime. Amounts here are in euro; the pricing page shows the price for your own country.
How is Promvia different from Google Analytics?
Google Analytics buries AI-assistant visits inside "direct" or "referral" and tells you nothing about whether AI recommends you. Promvia separates AI traffic, attributes revenue to the AI source that drove each visit, and — the part GA simply can't do — tracks whether AI actually cites and recommends you, then hands you the fixes to improve it.
Does Promvia work with Shopify?
Yes. Connect your Shopify store and Promvia automatically attributes order revenue to the AI source associated with the visit — no extra code. For the tracking snippet, any site builder works (WordPress, Webflow, Wix, custom sites…).
Is there an API or MCP server?
Yes, on Pro and Agency. The read-only REST API covers the full product surface — sites, visibility score, citations and their history, evidence, cited sources, GEO audit and actions, deep-scan results, traffic & revenue, plus a /usage endpoint listing every allowance. An MCP server exposes the same data to AI agents (Claude Desktop, IDEs and other tools); write tools — adding prompts, starting runs and scans — need a scoped OAuth grant. One shared pool covers both surfaces: 10,000 requests/month on Pro, 50,000 on Agency, with limits in every response header. Full docs at promvia.app/developers.
How accurate is the AI-traffic detection?
Promvia confirms an AI visit two ways: the referrer the browser sends (chatgpt.com, perplexity.ai, and so on), and the tag some assistants add to the link itself — which is what keeps their phone apps measurable, since an in-app browser strips the referrer. Measured on 2026-08-23 across eight surfaces, five identified themselves and three sent nothing at all: an industry-wide limitation no tool can solve, because the assistant decides what to send. Promvia labels those separately as "likely AI" (inferred from citations) and never mixes them into the confirmed number. The citation tracking (does AI recommend you) doesn't rely on referrers at all. We also run these same checks on ourselves and publish the scoreboard live at promvia.app/live — losses included.
Which countries and languages does it support?
Citation checks can be localized to 50+ markets, so a question like "best running shoes" is asked the way a local buyer would, in the local language. The Promvia app itself is available in English and Turkish.
Can I track competitors?
Yes. For every tracked question Promvia shows which competitors AI recommends instead of you, your share of voice against them, and the third-party sources AI cites — so you can see exactly who is appearing and what evidence sits behind them.
Choosing your engines
On every paid plan you choose which AI engines your questions are asked on — ChatGPT, Perplexity, Gemini, Claude, Google AI Overviews and Google AI Mode — and, for the low-cost ones, how often. The account owner changes them in Settings → Engines & schedule, and the number of questions you can track updates as you tick, before you save. No engine is sold as an add-on.
Engines do not cost the same to ask. Of the default engines, ChatGPT costs the most for a full check, then Claude; Perplexity costs far less, and Gemini, AI Overviews and AI Mode the least. Grok, which you can add, costs more to ask than any of them. In daily checks, which ask each engine once, Gemini is the cheapest of all. So fewer engines, or cheaper ones, leave room for more questions, up to three times your plan's question count, and on Pro and Agency, weekly checks leave more room than daily ones. Pro tracks 80 questions on all 6 default engines, or 148 on ChatGPT, Perplexity and Gemini alone.
A change applies from your next check; a check already queued or running keeps the engines it was started with. Nothing is deleted: earlier results from an engine you drop stay in your history, and it is simply not asked again until you add it back. If your new engines leave room for fewer questions than you are running, Settings shows which ones would pause before you save and lets you choose which keep running. Paused questions keep their history and come back, oldest first, when there is room again.
Your automatic checks hold room only for the questions you track, plus a few more — not for every question your plan could hold. The rest of the month is yours for the on-demand checks you start yourself: Settings shows it as “Left”, in full checks on your engines. Add a question past that room mid-month and its automatic checks for the rest of the month come out of “Left”; if “Left” cannot cover them, the question is still added and its automatic checks start on the 1st of next month, which its row says.
Starter and daily checks
Starter checks weekly by default, plus a trend check every 3 days on 10 questions you pick, and tracks 20 questions on ChatGPT, Perplexity and Gemini. You can turn daily checks on for its low-cost engines (Perplexity, Gemini, AI Overviews and AI Mode); ChatGPT and Claude are always checked weekly. Turning daily on ends the trend check, and the daily checks take its place.
Each of these ends the trend check. With Perplexity and Gemini daily on those three engines, Starter tracks 22 questions. On the four low-cost engines, all daily, it tracks 23. On all 6 default engines with the four low-cost ones daily, it tracks 12: ChatGPT and Claude cost the most of them to ask, so adding them is what lowers the count.
From finding to fix
Coaching
For the questions AI answers without naming you, coaching reads your audit and your real citation results — including who was cited instead — and writes the content and authority moves aimed at those gaps. Starter gets one coaching plan a month; Pro and Agency can ask any time.
Content briefs and drafts
On Pro and Agency, pick a question you are missing and Promvia writes a content brief — what the page has to answer and which sources AI already trusts on it — and, if you want it, a full page draft to edit and publish yourself.
Applying a fix
Every item on the Fix list opens a fix pack: what to change and why, the exact file or snippet to paste where there is one, step-by-step instructions for your platform, and how to confirm it worked on the next audit or check. Promvia never changes your site on its own.
API
Read API
Pull your Promvia data programmatically with a per-account API key. Create one in Settings → Integrations → API keys, then send it as an "Authorization: Bearer" header. The surface is 13 endpoints — visibility score, citations and evidence, sources, GEO audits, deep scans, traffic metrics, usage — with a matching MCP server; the three below are examples, the full reference lives at promvia.app/developers.
GET /api/v1/sites— your tracked sitesGET /api/v1/sites/{id}/metrics— AI visits, attributed revenue, traffic share, visitor quality, and the by-source breakdownGET /api/v1/sites/{id}/citations— tracked questions, mention status, and your share of voice
Example response (GET /api/v1/sites):
MCP server (for AI agents)
Let AI agents — Claude Desktop, IDEs, and other MCP clients — query your Promvia data directly. Point the client at the MCP endpoint below and authenticate with the same API key (as an "Authorization: Bearer" header). Add this to your client's MCP config:
The agent can then ask about your sites, AI-visit metrics, and citations in plain language.