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 action plan: 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".)
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 the Citations page 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 query, 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?
The major AI assistants — including ChatGPT, Claude, Perplexity, Gemini and Copilot — and new ones are quick to add as they appear.
Is my visitors' data private?
Promvia records which AI source sent a visit and which page they landed on — it doesn't collect names, emails, or personal details from your visitors. 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 7 visibility surfaces, 10 queries, daily tracking, weekly auto-check, one GEO coaching plan a month); Pro at €89/month (up to 5 sites, 30 queries, GEO coaching on demand, content briefs, API and MCP); Agency at €349/month (up to 15 sites, 150 queries, white-label client reports included). White-label is also a €19/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, and paying yearly costs ten months instead of twelve. No credit card to start, and you can cancel anytime.
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 the Pro plan. A read-only REST API exposes your sites, metrics, and citations, and an MCP server lets AI agents (Claude Desktop, IDEs, and other tools) query your Promvia data directly.
How accurate is the AI-traffic detection?
Promvia confirms an AI visit from the referrer the browser sends (chatgpt.com, perplexity.ai, and so on). Some AI clicks arrive with no referrer — an industry-wide limitation no tool can fully solve — so 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.
Which countries and languages does it support?
Citation checks can be localized to 50+ markets, so a query 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.
API
Read API
Pull your Promvia data programmatically with a per-account API key. Create one in Settings → API keys, then send it as an "Authorization: Bearer" header.
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 queries, 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.