> ## Documentation Index > Fetch the complete documentation index at: https://docs.devtune.ai/llms.txt > Use this file to discover all available pages before exploring further. # DevTune Key Concepts and Terminology > Reference for core DevTune concepts: projects, prompts, brands, tracked URLs, citations, share of voice, presence rate, and AI Search visibility metrics. 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 ### 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** The Brand Mentions metric is separate from Overall Presence Rate: an uncited text mention of your brand contributes to Brand Mentions, but not to Overall Presence Rate. ## 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 Only Cloudflare and edge middleware see answer fetches and 404 demand. ## 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: | State | Meaning | How it gets there | | - | - | - | | **Suggested** | DevTune proposed it and nobody has decided yet | DevTune ranks it into the queue | | **Accepted** | Your team wants it done; an owner may be assigned | Select **Accept** | | **Live** | The change is published; DevTune is measuring it or has measured it | Select **Mark live** and enter the published URL | | **Archived** | Off the queue | Select **Archive** | You can also move an action back. See [Move an action](/insights-actions/actions-hub#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](/projects/project-settings#pages-tab). ### Briefs A **brief** is the build-ready plan for an action. Brief generation uses agent credits. See [Briefs](/insights-actions/actions-hub#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](/insights-actions/outcomes). ### 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](/getting-started/first-project)** - Set up your tracking * **[Explore Home](/getting-started/dashboard-overview)** - Learn your way around * **[Understand Visibility Metrics](/search-tracking/visibility-metrics)** - Dive deeper into metrics This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.