RANKVERI
RANKVERI Learning Center·Batch 8

Official Documentation & Step-by-Step Guide

Comprehensive, factual, and structured guide to all features of the RANKVERI platform.

Table of Contents (12)

01

Introduction to GEO & Fundamental Concepts

Understand the difference between traditional SEO (Google) and GEO (generative AI engines).

Key concept

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).

Classic SEO (Google)

Users click on a list of 10 blue links. You optimize keywords, backlinks, and title tags to drive clicks to your website.

GEO (AI Engines)

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.
02

Quickstart: Your First Measurement in 3 Steps

How to configure your first site and launch a measurement wave in under 3 minutes.

Step-by-step tutorial
1Add your website

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.

2Select your site in the top navigation bar

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.

3Trigger a measurement wave

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!

03

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):

Option A: HTML Meta Tag (Instant)

Insert the tag <meta name="vizia-site-verification" content="..." /> into the <head> section of your homepage. Click "Verify": validated in 2 seconds.

Option B: DNS TXT Record

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).

04

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:

Cited (Green)

Your brand is clearly mentioned, linked to its domain, or recommended as a priority solution.

Not Cited (Pink)

The AI recommended competitor solutions without mentioning your brand. A content optimization opportunity is identified.

Uncertain (Amber)

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.

05

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, or Google-Extended.
  • Schema.org Semantic Markup (JSON-LD): Organization, Product, and FAQPage blocks 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.
Integrity Rule: An audit never modifies your target site. It operates strictly read-only and provides concrete recommendations to apply in your CMS.
06

AI Writing, GEO Exhaustiveness Score & Human Approval

Produce GEO-optimized content with a mandatory human approval workflow.

Human Validation

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:

DRAFT→IN REVIEW→APPROVED→PUBLISHED

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.

07

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).

Scientific Honesty Rule:

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.

08

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.

Frozen Data

A generated report is captured at a specific point in time. Its numbers never change, providing a reliable historical record for your monthly reviews.

Secure Client Sharing

The public share link exposes only the specified site's data, without revealing secret prompts, API costs, or other client sites in your agency.

09

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:

OWNERTotal control, billing, permanent data purge, API keys
ADMINISTRATOR (ADMIN)Management of sites, members, and waves
EDITORQuery creation, article drafting and publishing
ANALYSTRead-only view of metrics and reports
CLIENT GUESTStrictly limited to reports for their single assigned site
Site Scope: You can assign an Editor or Analyst role while restricting their scope to specific sites. They will not see any other sites in the portfolio.
10

Trash Bin, Retention & Permanent Purge

Understand soft delete mechanisms and the 30-day retention guarantee.

Legal retention

In accordance with audit trail and compliance requirements, no user-initiated site deletion is destructive by default.

How It Works Step-by-Step:

  1. Soft Delete: When an Administrator clicks Delete, the site is archived in the trash bin. Automatic waves are immediately halted to stop API costs.
  2. 30-Day Retention Window: The site and its entire history remain safely intact for 30 calendar days.
  3. 1-Click Restoration: During these 30 days, you can restore the site anytime (provided your subscription plan has available site quota).
  4. Permanent Purge (Owner Only): Irreversible deletion is strictly reserved for the Account Owner and fully logged in the audit trail.
11

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.
12

FAQ & Step-by-Step Troubleshooting

Direct answers to common questions and resolution of frequent issues.

Why is my site never cited by AI models?

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.

How do I restart the guided tutorial tour?

Simply click the Tutorial button in the top navigation bar. The interactive walkthrough for your current page will start immediately.

What happens if I reach my monthly LLM budget ceiling?

New measurement waves are automatically paused to prevent unexpected overage charges. You can increase your budget ceiling anytime in Administration → Measurement & Detection.