Search Tracking Configuration

All search tracking configuration is managed from a single centralized Config page. This page provides four tabs that control every aspect of what DevTune tracks and how it analyzes AI search results.

​

Accessing the Config Page

Navigate to AI Search Tracking > Config in your project sidebar. The Config page is located at /search-tracking/config within your project.

​

Platforms Tab

The Platforms tab controls which AI search platforms DevTune queries during automated test runs.

​

Available Platforms

DevTune supports five AI search platforms:

​

Platform Availability by Plan

Platform access is determined by your subscription tier:

• Free - Gemini only
• Starter ($49/mo, 7-day trial) - ChatGPT, Perplexity, Gemini
• Plus ($99/mo) - ChatGPT, Perplexity, Gemini
• Pro ($199/mo) - All 5 platforms (adds Google AI Mode and Grok)
• Enterprise (custom pricing) - All 5 platforms

Platforms not included in your current plan appear as locked with an upgrade prompt.

​

Enabling and Disabling Platforms

Toggle each available platform on or off. Only enabled platforms are queried during test runs. Disabling a platform does not delete historical data from that platform.

​

Citation Sources Tab

The Citation Sources tab manages the domains DevTune looks for in AI search responses. Citation sources are organized by brand.

​

Adding a Citation Source

1. Select the brand this domain belongs to (your primary brand or a competitor)
2. Enter the domain (e.g., docs.yourcompany.com)
3. Optionally add a tag to categorize the domain (e.g., “docs”, “blog”, “marketing”, “github”)
4. Save

​

Domain Format

Enter domains without the protocol prefix:

• docs.yourcompany.com - Correct
• https://docs.yourcompany.com - Incorrect

Each subdomain should be added separately:

• yourcompany.com - Main site
• docs.yourcompany.com - Documentation
• blog.yourcompany.com - Blog

​

Domain Tags

Tags help categorize citation sources for filtered analysis. Common tags include:

• docs - Documentation sites
• blog - Blog content
• marketing - Product and landing pages
• github - Source code repositories
• package - Package registry pages (npm, PyPI, etc.)

​

Suggested Competitors

When adding citation sources for competitor brands, DevTune can suggest relevant competitor domains based on your product context and category. This feature helps ensure you are tracking the right competitor domains.

​

Editing and Removing Citation Sources

Click any citation source to edit its domain, brand assignment, or tags. Remove a citation source by clicking the delete action. Historical data for removed citation sources is preserved.

​

Brand Terms Tab

The Brand Terms tab manages the name terms DevTune monitors for brand mentions in AI responses.

​

What Brand Terms Do

Brand terms detect when an AI platform mentions a brand by name in its response text, regardless of whether a citation URL is present. For example, if an AI response says “Consider using ProductName for this use case” without linking to any URL, the brand mention is still detected if “ProductName” is configured as a brand term. Brand terms are distinct from prompts. Brand terms define what to look for in AI responses. Prompts define what to ask the AI platforms.

​

Adding Brand Terms

1. Select the brand this term belongs to
2. Enter the brand term (e.g., “YourProduct”)
3. Save

​

Recommended Brand Terms

For each brand, add:

• The official product name
• Common abbreviations or short forms
• Variations users might use
• Domain name without TLD if commonly referenced

Example for a brand called “DataForge”:

• “DataForge”
• “Data Forge”
• “dataforge”

​

Primary vs. Competitor Brand Terms

Brand terms are classified based on the brand they belong to:

• Primary brand terms contribute to your Brand Mention Rate metric
• Competitor brand terms contribute to competitive Share of Voice analysis

​

Brands Tab

The Brands tab manages your primary brand and competitor brands. Brands are the organizational foundation that ties citation sources and brand terms together.

​

Primary Brand

Your primary brand is created automatically during project setup. It represents your product. The primary brand cannot be deleted, but its name and details can be edited. The primary brand determines:

• Which citation sources count as “yours” in metrics
• Which brand terms count as “yours” for brand mention tracking
• The baseline for all competitive comparisons

​

Competitor Brands

Add competitor brands to enable competitive analysis. Each competitor brand can have its own:

• Citation sources (competitor domains)
• Brand terms (competitor name variations)

Competitor brands enable:

• Share of Voice calculations
• Competitive gap analysis
• Defend-position and competitive-weakness insights

​

Adding a Competitor Brand

1. Click Add Brand on the Brands tab
2. Enter the competitor brand name
3. Save
4. Then add citation sources and brand terms for this competitor on the respective tabs

​

Removing a Competitor Brand

Removing a competitor brand also removes its associated citation sources and brand terms from active tracking. Historical data is preserved.

​

Configuration Best Practices

​

Start Focused, Expand Later

Begin with:

• 3-5 citation sources for your primary brand
• 2-3 competitor brands with their key domains
• Core brand terms for each brand
• All platforms available on your plan

Expand tracking as you understand what drives the most useful insights.

​

Review Configuration Regularly

Periodically review your Config page to:

• Add new domains if you launch new sites or documentation
• Add new competitors as your market evolves
• Update brand terms if your product name or branding changes
• Enable new platforms as they become available with plan upgrades

​

Keep Brand Terms Precise

Use exact brand names rather than generic terms. Generic terms like “analytics” or “testing” will produce false-positive brand mentions. Brand terms should be specific enough to unambiguously identify a brand.

​

Troubleshooting

​

No Results for a Citation Source

If a citation source never appears in results:

• Verify the domain is entered correctly without typos
• Check that the domain has content relevant to your tracked prompts
• Note that AI platforms may not have indexed your content yet

​

Unexpected Brand Mentions

If brand mention counts seem too high or too low:

• Review brand terms for overly generic terms that match unrelated content
• Check for missing brand term variations that users commonly use
• Verify brand term assignment to the correct brand

​

Next Steps

• Citation Sources - Detailed guide to citation source management
• Brand Terms - Detailed guide to brand term management
• Brands - This page covers brands configuration
• Running Search Tests - Understand how automated tests work