Skip to main content
Use this guide after the activation wizard to review and refine what DevTune tracks: brands, tracked URLs, brand terms, platforms and prompts. Getting these right lets DevTune label citations and mentions correctly.

Before You Start

You will need:
  • A DevTune project. To create one, follow the activation wizard in the Quickstart.
  • An understanding of which brands and URLs represent you and your competitors

Where Setup Happens

AI Search setup spans two places:
  • Settings - General, Context, Brands, Platforms, Pages, Sharing, and Integrations, plus Content preferences on plans that include it
  • Insights › Visibility → Prompts - Prompt and topic management
Tracked URLs and brand terms are managed per brand inside the Brands tab.

Step 1: Review the General tab

Open Settings › General and confirm:
  • Project name
  • Description
  • Product context
If the product context is wrong or outdated, fix it before tuning anything else. It influences how DevTune evaluates relevance and generates recommendations.

Step 2: Configure Brands, tracked URLs, and brand terms

Open Settings › Brands. This tab shows:
  • A brand list on the left
  • A detail panel for the selected brand on the right
Changes to brands and tracked URLs label citations collected from that day on. Earlier citations keep the labels they were recorded with, and the timeline marks each day you make a change. Set this tab up before your first runs, so the baseline is labelled correctly.

Primary brand

Your primary brand is created during setup and represents your product. It defines which citations and mentions count as “yours.”

Competitor brands

Add competitor brands you want to track alongside your own. Once runs complete, Suggested Competitors lists commercial domains frequently cited in them; select Add to track one. Archiving a competitor stops tracking it and keeps its recorded data as history. You can restore it later. See Archive a competitor brand.

Tracked URLs

Within a brand’s detail panel, add the domains or URLs DevTune should match as citations, such as:
  • Marketing site
  • Docs
  • Blog
  • GitHub repository
  • Package registry pages

Brand terms

Also within the same detail panel, add the text terms that should count as brand mentions, such as:
  • Official product name
  • Common variations
  • Common abbreviations

Step 3: Enable AI Search platforms

Open Settings › Platforms and enable the AI Search engines you want DevTune to query. Platform availability depends on your plan:
  • Plus - ChatGPT, Perplexity, Gemini
  • Pro and Agency - ChatGPT, Perplexity, Gemini, Google AI Mode, Microsoft Bing Copilot
  • Enterprise - Everything on Pro, plus Claude and Grok, checked weekly
Disabling a platform stops future runs on that engine but does not remove historical data already collected.

Step 4: Manage prompts and topics

Open Insights › Visibility, then the Prompts tab, to review the queries DevTune is sending. From this tab you can:
  • Add or edit prompts
  • Group prompts into topics
  • Review prompt-level performance
  • Use competition status (Winning, Contested and Open) to prioritize coverage
Prompts define the actual questions DevTune submits to the enabled AI platforms, so they are one of the highest-leverage parts of the setup.

Step 5: Let runs accumulate

Once brands, tracked URLs, terms, prompts, and platforms are configured, DevTune runs each active prompt once a day on most enabled platforms, and weekly on some. As runs complete, you will see data appear in these Insights › Visibility tabs:
  • Dashboard
  • Prompts
  • Citations
  • Competitors
  • Explore

Optional: Connect AI Traffic sensors

You can also open Settings › Integrations and connect the sensors that measure AI traffic: the tracking snippet for referral sessions, Cloudflare, edge middleware or a Vercel log drain for crawler traffic, GA4 or PostHog for conversions, and Search Console for classic-search comparison. None of this is required for Visibility itself, but it gives you downstream demand context in Insights › AI Traffic. See Which sensors do I need.

After Setup

Establish a baseline

Your first completed runs establish the baseline for:
  • Presence
  • Share of Voice
  • Brand mentions
  • Citation coverage

Expect some variability

AI Search results are not perfectly deterministic. Focus on patterns across multiple runs rather than any single response.

Troubleshooting

No results appearing

If you do not see results:
  • Confirm that at least one platform is enabled
  • Confirm you have prompts configured
  • Confirm your brands, tracked URLs, and brand terms are present
  • Give the scheduled runs time to complete

Unexpected results

If results seem off:
  • Review tracked URLs for typos or missing properties. A fix labels citations from that day on, not earlier ones
  • Review brand terms for missing or overly broad matches
  • Confirm you are looking at the correct platform/date filters

Next Steps