Official Documentation & Step-by-Step Guide
Comprehensive, factual, and structured guide to all features of the RANKVERI platform.
Table of Contents (12)
Introduction to GEO & Fundamental Concepts
Understand the difference between traditional SEO (Google) and GEO (generative AI engines).
GEO (Generative Engine Optimization) encompasses all the methods that allow a brand, product, or service to be cited, recommended, and sourced by conversational AI engines (ChatGPT, Claude, Gemini, Perplexity, Grok).
Users click on a list of 10 blue links. You optimize keywords, backlinks, and title tags to drive clicks to your website.
AI synthesizes a direct response and recommends only 2 or 3 trusted brands. If you are not cited in the AI text, you are completely invisible.
The 3 Core Metrics Measured by RANKVERI:
- Citation Rate: Percentage of times your brand is explicitly mentioned in the AI model's answer.
- Confidence Score: Certainty index (from 0% to 100%) validating that the citation unambiguously refers to your business and not a namesake.
- Share of Voice: Proportion of recommendations awarded to your brand compared to all your designated competitors.
Quickstart: Your First Measurement in 3 Steps
How to configure your first site and launch a measurement wave in under 3 minutes.
Navigate to Monitored Sites (/sites) and click Add a site. Enter your domain (e.g. my-business.com) without https:// or www., and specify 2 or 3 direct competitors.
At the top left of the screen, click the site switcher to ensure your site is active. The entire platform will automatically filter data for this domain.
Go to AI Visibility (/visibilite) and click Run a wave. RANKVERI simultaneously queries ChatGPT, Claude, Gemini, Perplexity, and Grok. In moments, your first score will appear!
Site Portfolio, Verification & CMS Connection
Verify domain ownership and synchronize your CMS one-click publishing keys.
RANKVERI manages your sites as a unified portfolio. Each site retains its own monitoring queries, distinct competitors, brand voice, and CMS key.
Two Domain Ownership Verification Methods (Your Choice):
Insert the tag <meta name="vizia-site-verification" content="..." /> into the <head> section of your homepage. Click "Verify": validated in 2 seconds.
Add a TXT record with your registrar (Cloudflare, AWS Route53, GoDaddy) containing vizia-verification=your_token. Ideal when you lack direct source code access.
Supported CMS for 1-Click Publishing:
WordPress (Application Password REST API), Shopify (Admin Access Token), Webflow (v2 API Token), or Custom Webhook (JSON POST with title, markdown body, and status).
AI Visibility, Citation Detection & Share of Voice
How RANKVERI queries the 5 AI engines without fabricating data (ground-truth principle).
In accordance with our core principles of integrity and truth, RANKVERI never generates fake metrics. Every reading corresponds to a live API exchange with the provider or a clearly traceable simulation (Mock).
The 3 possible verdicts for an AI answer:
Your brand is clearly mentioned, linked to its domain, or recommended as a priority solution.
The AI recommended competitor solutions without mentioning your brand. A content optimization opportunity is identified.
Partial mention or common word requiring semantic arbitration to avoid false citation attribution.
Multi-Pass Sampling (N = 3 to 5):
LLMs are probabilistic: a question asked twice may yield two slightly different answers. RANKVERI repeats each query multiple times and calculates the mathematical average for honest and reproducible results.
Technical GEO & SEO Audit: Making Your Site Readable by AI
Verify technical compatibility of your web pages for AI indexing crawlers.
For models like ChatGPT or Claude to recommend your business, they must be able to read, understand, and index your technical content without obstacles.
The 4 pillars of RANKVERI technical audits:
- Robots.txt Directives: Verifies you are not blocking
GPTBot,ClaudeBot,PerplexityBot, orGoogle-Extended. - Schema.org Semantic Markup (JSON-LD):
Organization,Product, andFAQPageblocks allow LLMs to extract your prices, warranties, and features with certainty. - Textual Clarity & HTML5 Tags: Hierarchical H1-H3 headings, structured data tables, and concise answers to direct questions.
- Load Speed (Core Web Vitals): Fast response times so crawler bots index your pages without timeouts.
AI Writing, GEO Exhaustiveness Score & Human Approval
Produce GEO-optimized content with a mandatory human approval workflow.
RANKVERI features an AI-assisted writing studio to produce in-depth articles, comparative guides, and FAQ pages calibrated to answer queries from LLMs directly.
The absolute article lifecycle rule:
No automatic publishing: To protect your brand image and prevent AI hallucinations, transitioning to the Published status strictly requires human validation by an account holding the content.publish permission.
RANKVERI GEO Exhaustiveness Score (0 to 100):
Computed in real time as you write, this score checks for essential semantic entities, clear definitions, and summary tables that motivate AI models to cite your article as a reference.
ROI Proof: Revenue & AI Conversions
Demonstrate the real financial value generated by conversational AI engines.
The ROI Proof module correlates mentions obtained in AI responses with real web traffic and revenue recorded on your website.
How does AI traffic attribution work?
RANKVERI automatically identifies web sessions originating from conversational engines (e.g., referrer containing chatgpt.com, claude.ai, perplexity.ai, or specific URL tags).
Any financial value attributed to AI is explicitly labeled as an estimate. The formula (Qualified AI Visits × Average Conversion Rate × Average Order Value) is always transparently shown.
Consolidated Reports & White-Label Sharing
Create instant reports, export them to PDF, or share them securely with clients.
Designed for agencies and marketing teams, this module compiles all visibility, technical audit, and ROI metrics into a clean, professional document.
A generated report is captured at a specific point in time. Its numbers never change, providing a reliable historical record for your monthly reviews.
The public share link exposes only the specified site's data, without revealing secret prompts, API costs, or other client sites in your agency.
Governance, Members, Roles & Per-Site Scope
Manage your team using the 5-role matrix and per-site access scoping.
RANKVERI includes a granular permissions system allowing safe collaboration within a single organization.
The 5 User Roles:
Trash Bin, Retention & Permanent Purge
Understand soft delete mechanisms and the 30-day retention guarantee.
In accordance with audit trail and compliance requirements, no user-initiated site deletion is destructive by default.
How It Works Step-by-Step:
- Soft Delete: When an Administrator clicks Delete, the site is archived in the trash bin. Automatic waves are immediately halted to stop API costs.
- 30-Day Retention Window: The site and its entire history remain safely intact for 30 calendar days.
- 1-Click Restoration: During these 30 days, you can restore the site anytime (provided your subscription plan has available site quota).
- Permanent Purge (Owner Only): Irreversible deletion is strictly reserved for the Account Owner and fully logged in the audit trail.
AI Model Monitoring & Budget Ceiling
Track live API consumption across OpenAI, Claude, Gemini, Perplexity, and Grok.
Accessible to Administrators (/administration/monitoring), this module provides full financial transparency over your AI model costs.
Monitoring Features:
- Monthly Budget Gauge: Compares cumulative USD spend against the ceiling set in your workspace settings.
- Breakdown by Engine: Identify the exact cost share from ChatGPT, Claude, Gemini, Perplexity Sonar, and Grok.
- Per-Site Consumption: Pinpoint which domain in your organization is utilizing the most queries.
- Last 25 API Calls Log: Timestamp, queried model, status (Success, Failure, Mock), and calculated unit cost.
FAQ & Step-by-Step Troubleshooting
Direct answers to common questions and resolution of frequent issues.
First check the Technical Audit to ensure your robots.txt does not block GPTBot or ClaudeBot. Next, ensure you have Schema.org JSON-LD describing your offering, and create targeted articles addressing buyer intent queries.
Simply click the Tutorial button in the top navigation bar. The interactive walkthrough for your current page will start immediately.
New measurement waves are automatically paused to prevent unexpected overage charges. You can increase your budget ceiling anytime in Administration → Measurement & Detection.
