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
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
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
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
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
Next Steps
- Create Your First Project - Set up your tracking
- Explore Home - Learn your way around
- Understand Visibility Metrics - Dive deeper into metrics