ViaMetric Logo
ViaMetric
Login
DocsQuick Start: Configure Viametric

Quick Start: Configure Viametric

Learn how to configure Viametric, track mentions, and optimize your content for AI search engines.

Follow this guide to set up Viametric, start tracking your brand's presence across AI platforms, and optimize your content for better visibility.

1. Basic Configuration

First, connect your website to Viametric:

  1. Navigate to the Settings page (/settings).
  2. Enter your Website ID and Domain.

Viametric Settings

2. Technical Tracking Setup (Optional)

To monitor SEO metrics and detect AI bot activity on your dashboard, add our tracking code to your website.

Option A: Full Analytics (Script)

Best for tracking both humans and AI traffic. Add this line inside the <head> of your website:

<script defer src="https://viametric.app/events.js" data-website-id="YOUR_WEBSITE_ID"></script>

Option B: AI-Bot Detection (Tracking Pixel)

Highly Recommended. Since most AI bots (like GPTBot) do not execute JavaScript, the script above won't detect them. Add this 1x1 pixel tag to catch AI scrapers:

<img src="https://viametric.app/api/beacon?id=YOUR_WEBSITE_ID" width="1" height="1" style="display:none" alt="viametric-pixel" />

Framework Integration (Next.js)

Add both to your root layout.tsx:

<head>
  <script defer src="https://viametric.app/events.js" data-website-id="YOUR_WEBSITE_ID" />
  <img src="https://viametric.app/api/beacon?id=YOUR_WEBSITE_ID" width="1" height="1" style={{display:'none'}} alt="viametric-pixel" />
</head>

Note: We track localhost by default so you can test during development.

3. Track & Analyze Mentions

Once configured, you can start monitoring how AI models perceive your brand.

  1. Go to the Mentions page (/mentions).
  2. Add the keywords you want to track (e.g., GEO, ChatGPT traffic analysis).
  3. Start Analysis: Click the button located to the left of the keyword chip.
    • This will launch a real-time analysis across ChatGPT, Perplexity, and Gemini.

Tracked Keywords

4. AI Citation Feed & Optimization

After the analysis completes, the results will appear in the AI Citation Feed table.

AI Citation Feed

Understanding the Results

Expand any row in the table to view detailed insights:

  • AI Response: The actual answer provided by the AI model.
  • Ranking & Citations: How prominently your brand is featured.
  • Sentiment Analysis: The overall tone of the mention.
  • Optimization Tips: Specific suggestions to improve your ranking.

Actionable Tools

Inside the expanded view, you will find powerful tools to improve your visibility:

  • Generate FIX: Creates AI-Optimized Content tailored to address gaps or improve sentiment. You can use this content directly on your website to better answer user queries.
  • JSON-LD Schema: Generates a Semantic Structure code block. Paste this into your website's <head> section to help AI crawlers better understand and index your content.
viametric-pixel