Skip to main content
Before diving deeper into DevTune, it helps to understand the key concepts and terminology used throughout the platform.

Core Concepts

Projects

A project is your workspace for tracking one product or brand. Projects contain:
  • Tracked prompts and the Visibility results they produce
  • Brands, tracked URLs, and brand terms
  • Audit readiness for your domains and pages
  • Traffic from AI systems: crawls, answer fetches, referrals, and 404 demand
  • Actions, their briefs, and the agents that draft them
  • Results: before-and-after measurement and detected page changes

Product Context

Product context is the structured description of what your product does. During project creation, DevTune generates this automatically from your website URLs. You can review and edit it later from Settings › General. Good product context leads to better prompt suggestions and more relevant recommendations.

Brands

Brands are the organizational concept for competitive tracking. Each project has:
  • A primary brand - your product or company
  • Competitor brands - the brands you want to compare against
Each brand has associated tracked URLs and brand terms that DevTune uses to identify citations and mentions in AI responses.

AI Search Concepts

AI Search Platforms

DevTune monitors your visibility across AI-powered search platforms. The platforms available depend on your plan tier:
  • ChatGPT - Plus and above
  • Perplexity - Plus and above
  • Gemini - Plus and above
  • Google AI Mode - Pro and above
  • Microsoft Bing Copilot - Pro and above

Prompts

Prompts are the search queries you want to track across AI platforms. These are the kinds of questions users might ask when looking for solutions your product provides. Prompts are managed from the Prompts tab in Insights › Visibility.

Brand Terms

Brand terms are the text terms DevTune monitors for brand mentions in AI responses. These typically include your product name, company name, and common variations or abbreviations. Brand terms are configured per brand from Settings › Brands.

Tracked URLs

Tracked URLs are the domains and URLs DevTune monitors when they appear as citations in AI Search results. This typically includes:
  • Your marketing website
  • Your documentation site
  • Your GitHub repository
  • Competitor properties
Tracked URLs are managed per brand from Settings › Brands.

Citations

A citation is an AI platform sourcing a URL in its answer. Citations show which of your pages are referenced and how prominently they appear. A mention is your brand named in the answer text. Citations and mentions are separate metrics and never interchangeable.

Key Metrics

Core metrics

These are the top-level metrics that summarize your AI Search visibility:
  • Presence Rate - The percentage of completed AI answers with citation data that cite at least one URL tracked to your brand
  • Share of Voice - Your citations as a share of your citations plus your tracked competitors’ citations. Citations of other sources are not counted.
  • Sentiment - How positively or negatively AI platforms describe your brand when they mention it
  • Average Position - Your average position among cited sources, in answers that cite you

More metrics

These provide deeper insight into specific aspects of your visibility:
  • Docs Presence
  • Blog Presence
  • Brand Mentions
  • Top 3
  • Primary Citation Share
The Brand Mentions metric is separate from Presence Rate: an uncited text mention of your brand contributes to Brand Mentions, but not to Presence Rate. See Visibility metrics for each definition.

AI Traffic Concepts

Insights › AI Traffic counts three kinds of AI activity separately:
  • Crawls - AI systems such as GPTBot or ClaudeBot retrieving your pages to index them
  • Answer fetches - AI systems retrieving a page to build an answer to a question
  • Referrals - visitors who arrive at your website from an AI answer

404 Demand

404 demand is pages AI systems keep requesting that don’t exist on your site. Because it comes from real requests, it points to content AI systems already expect to find.

Sensors

Sensors are what measure this activity. Connect them from Settings › Integrations:
  • Cloudflare - reads request logs for hostnames proxied through Cloudflare
  • Edge middleware - runs on Vercel and other app hosts
  • Vercel log drain - Vercel sends DevTune its AI crawler requests, with no code changes, and also records AI-tagged visits as at-least counts
  • Tracking snippet - a lightweight JavaScript snippet that records AI referrals, plus any AI bots that run JavaScript
Only the three crawler sensors, Cloudflare, edge middleware and the Vercel log drain, see answer fetches and 404 demand. See Which sensors do I need.

Actions Concepts

Actions

An action is a fix DevTune recommends, or one you add yourself, ranked by measured opportunity and carrying the evidence behind it. Every action is in one of four states: You can also move an action back. See Move an action:
  • Block and Unblock flag an accepted action that can’t progress. It stays accepted and shows Blocked.
  • Reopen moves a live action back to Accepted. Its measurement so far stays in Results, and marking it live again continues the same window.
  • Restore returns an archived action to where it was before.

Suggestions

Suggestions are actions in the Suggested state: evidence-backed recommendations generated from the current state of your project. Suggestions steer around locked pages.

Briefs

A brief is the build-ready plan for an action. Brief generation uses credits. See Briefs.

Measured Actions

When you mark an action live, DevTune compares the 14 days before with the 14 days after, on answers citing the page and on answer fetches. The action’s result in Results is one of Improved, Mixed, No clear change, Declined, Still measuring, or Unmeasured when there is no usable evidence. A result shows what moved in that window; it does not prove the action caused it. See Results.

Agent Credits

Credits pay for agent runs, briefs and other work that uses AI models. Your account holds one balance, funded by your plan’s monthly allowance and by credit packs you buy. See Credits for how the balance is funded, when it expires and what each use costs.

Team Concepts

Team Account

A team account is the shared workspace where projects are managed.

Roles

Each person has a team role:
  • Owner - Full access including billing, invitations, member management, role management and team settings
  • Member - Works on projects and actions, but can’t manage billing, roles, members or team settings
  • Viewer - Starts as Viewer on every project, and can’t create projects
Each person also has a role on each project, Admin, Member or Viewer. On Agency and Enterprise, an Owner can limit someone to chosen projects; a project Admin can invite people to their own Admin projects. See Roles and permissions for what each role can do.

Next Steps