Visperity AI & EnSightX™ User Guide

Welcome to the Visperity Help Center! Visperity provides an enterprise suite of AI search, conversational virtual assistants, multi-language catalog translation, and EnSightX™ AI website speed & business performance intelligence—designed to help merchants maximize sales conversions, improve Google search rankings, and optimize store operations.

This documentation is written specifically for store owners, e-commerce managers, marketers, and web teams. No programming or server administration knowledge is required.

Documentation Sections

Explore the comprehensive step-by-step user guides below:

AI Search & Virtual Assistant Site Tools

1. Getting Started & Dashboard Overview

   • Dashboard navigation and section tabs
   • Creating and managing multiple Datasets
   • Saving and restoring Configuration Snapshots
   • Viewing Visitor Search & Inquiry Analytics
   • Plan quotas, usage tracking, and upgrades

2. Data Ingestion & Knowledge Base Management

   • How AI vector indexing works (in plain English)
   • Ingestion methods: Single Web Crawler, XML Sitemap, and CSV Bulk Upload
   • PDF & Word document indexing (.pdf, .docx, .doc)
   • Sectional & Anchor Tag URL Indexing (#section)
   • Ingestion Queue Monitor & Background Batch Processing
   • Multi-Language Knowledge Base Translation Manager
   • Category Tag System (Visual UX Labeling vs True Dataset Segmentation)

3. AI Virtual Assistant Builder

   • What the Virtual Assistant does
   • Customizing conversational prompts, greetings, and disclaimers
   • Styling colors, chat bubble positions, and custom icons
   • Scoped widget UI translations & 1-click AI auto-translate
   • Installing the Assistant on your website with one script tag
   • Complete Field & Setting Reference

4. Live Search Autocomplete Builder

   • What Live Search does
   • Connecting to your existing website search input box
   • Instant SKU matching, semantic search, and bold category tags
   • Configuring colors, thumbnails, prices, and hover highlights
   • Custom CSS & scoped Live Search UI translations
   • Installing Live Search on your website
   • Complete Field & Setting Reference

5. Embedded Search & Results Page Builder

   • What Embedded Search does
   • Setting up dedicated search results pages
   • Customizing results layout, pagination, price labels, image thumbnails, and category tags
   • Search Results Memory (Back-Button State Persistence)
   • Custom CSS & scoped Embedded Search UI translations
   • Installing Embedded Search on your website
   • Complete Field & Setting Reference

6. Multi-Language & Global Translation Guide

   • Two-tier translation architecture (Scoped UI vs Knowledge Base Vectors)
   • Strict language gating (preventing cross-language contamination)
   • Localizing widget text and builder labels with AI Auto-Translate
   • Centralized Multi-Language Knowledge Base Translation Manager in Datasets
   • Incremental delta translation queueing (Translate Untranslated)
   • Expandable child translation hierarchy with Edit, Retranslate, and Delete actions
   • Pricing, thumbnail image, and category tag translations

EnSightX™ AI Performance & Business Intelligence Suite

7. EnSightX™ Getting Started & Dashboard Overview

   • What is EnSightX™ and how speed drives sales conversions
   • Navigating the 5 main Control Panel sections
   • Running your first audit in 3 simple steps
   • Understanding your account quota meters

8. Understanding Speed Scores & Core Web Vitals

   • The 4 Google Health Scores: Performance, Accessibility, Best Practices, and SEO
   • Score color badges (🟢 Green, 🟡 Orange, 🔴 Red)
   • Why mobile testing is crucial for online shoppers and rankings
   • Core Web Vitals in plain English: LCP (Loading), TBT (Responsiveness), and CLS (Visual Stability)
   • Optimization Wins & passed audits

9. Tri-Stream AI Insights & Ready-to-Use Code Fixes

   • Connecting speed metrics with shopper traffic and Google search keywords
   • Understanding the AI Commercial Impact Headline
   • Prioritized Action Cards: Critical Fixes vs. Growth Opportunities
   • Using the interactive AI Code Fix Drawer to copy ready-to-use code snippets
   • Deep-diving into Traffic Sources, Search Engines, Devices, and Browsers

10. Connecting Google Analytics 4 & Search Console

    • Complete privacy: Isolated per-domain credentials for multi-store setups
    • Step-by-step Google Cloud connection guide for non-technical users
    • Inviting your service account as a Viewer in GA4 and Search Console
    • Using customizable Analytics Date Range filters (7d, 14d, 30d, 90d, 365d, or Custom)

11. Creating Branded Client & Stakeholder Reports

    • Creating executive presentations for clients, team members, or managers
    • Custom branding: Company logo, brand colors, custom notes, and white-labeling
    • Granular section controls: Choose exactly what data to include
    • Sharing via secure Public Web Links, PDF exports, and Excel (CSV) downloads

12. Tracking Improvements & Measuring ROI Over Time

    • Setting milestone baselines before launching site updates or redesigns
    • Proving ROI with automatic before-and-after improvement deltas (+X speed points, -Y sec load time)
    • Viewing interactive performance progression charts over weeks and months

13. Monitored Domains, Automated Schedules & Dev vs. Live Audits

    • Setting up Monitored Domains with friendly nicknames
    • Adding saved URLs for key store pages (Homepage, Collection, Product, Cart, Checkout)
    • Setting up automatic Weekly Background Scans
    • Running Dev vs. Live Comparative Audits to safety-check staging updates before pushing them live

14. Plan Limits, Quotas & Account Management

    • Overview of Visperity plan tiers (7-Day Trial, Store Owner, Developer, Agency)
    • How quota limits work (Monitored Domains, Daily Manual Audits, Weekly Auto-Scans)
    • Quota reset cycles and upgrading your subscription

Troubleshooting & Support

15. Troubleshooting & Frequently Asked Questions

    • Verifying script placement and domain whitelists
    • Missing search results / SKU keyword indexing
    • Updating prices, descriptions, or bulk CSVs
    • Removing discontinued products & deleted pages
    • EnSightX failing audits & Core Web Vitals diagnostics
    • How to apply recommended AI code fixes via the Code Fix Drawer
    • EnSightX 1-Stream vs Tri-Stream credentials troubleshooting
    • Fixing Google Service Account permission errors (403 Forbidden)
    • Automated weekly background scan troubleshooting
    • EnSightX mobile speed scores & Core Web Vitals FAQ
    • How AI calculates conversion & revenue uplift
    • Segmenting datasets for specific site areas (store vs KB)
    • Category Tags (UX labels) vs Dataset Segmentation (content isolation)
    • Google Cloud credentials and service account key security