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
Primary KPIs
These are the top-level metrics that summarize your AI Search visibility:- Overall Presence Rate - The percentage of completed AI Search responses 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 Score - How positively or negatively AI platforms describe your brand when they mention it
Secondary Metrics
These provide deeper insight into specific aspects of your visibility:- Docs Presence
- Blog Presence
- Brand Mentions
- Top of Answer
- Avg Citation Rank
- 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
- 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 agent 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
Agent credits power brief generation and related content workflows:- Your account holds one credit balance
- The plan’s monthly allowance funds it each billing anniversary and expires at the end of that month
- Purchased add-on credits fund the same balance and never expire
- Spending takes the expiring allowance first, so bought credits are what remain
- Brief generation uses agent credits only when you request it
Team Concepts
Team Account
A team account is the shared workspace where projects are managed.Roles
DevTune has two primary roles:- Owner - Full access including billing management, team settings, member management, and role management
- Member - Access to projects and analytics, with broad collaboration permissions
Next Steps
- Create Your First Project - Set up your tracking
- Explore Home - Learn your way around
- Understand Visibility Metrics - Dive deeper into metrics