Adoption Dashboard

The Adoption Tracking dashboard provides a comprehensive view of your package or library’s adoption metrics. This page walks through each section of the dashboard and explains how to interpret the data.

​

Accessing the Dashboard

1. Select your project from the account home page
2. In the sidebar, expand Adoption Tracking
3. Select Adoption Metrics to open the dashboard

​

Time Range Selection

A dropdown in the top-right corner lets you select the time range for all dashboard data:

• 7 days - Recent activity
• 30 days (default) - Monthly view
• 90 days - Quarterly trends
• 6 months - Half-year view
• 1 year - Annual trends
• All - Full history

The selected range persists as a URL parameter, so you can bookmark or share specific views.

Note: The Competitor Movement section always compares against 30 days ago, regardless of the selected time range. This provides a consistent reference point for competitive changes.

​

Adoption Health Score

The Health Score is a 0-100 gauge displayed prominently in the top-left of the dashboard. It provides an at-a-glance assessment of your adoption health.

​

Score Ranges

​

Score Breakdown

Hover over the Health Score to see a tooltip showing how each component contributes to the total:

• Download Growth (up to 35 points) - How your recent downloads compare to the prior period. Strong growth earns more points.
• Market Share Trend (up to 25 points) - Whether your share of total tracked downloads is growing, stable, or declining.
• Star Growth (up to 20 points) - GitHub star growth over the selected time range.
• Competitive Position (up to 20 points) - Your ranking among tracked competitors by download count. First place earns the most points.

Each component is color-coded green (above 50% of max) or red (below 50%) so you can quickly see what is helping or hurting your score.

​

Summary Stats

Four cards to the right of the Health Score show key metrics:

​

Your Downloads

The 4-week average of weekly downloads for your primary package. This smooths out day-to-day fluctuations and gives a stable measure of your current download volume.

​

Your Market Share

Your percentage of total downloads across all tracked packages. If you track your package plus three competitors, and you account for 40% of total downloads, your market share is 40%.

​

Your Rank

Your position among all tracked packages, ranked by download count. A rank of 1 means you have the most downloads among the packages you track.

​

Growth Rate

The 3-month download growth percentage for your primary package. A positive value means downloads are increasing; negative means they are declining.

​

Competitor Movement

The Competitor Movement section (“What’s Changed”) shows four cards highlighting competitive shifts over the last 30 days:

• Your Market Share - Current market share percentage with the change from 30 days ago
• Your Rank - Current rank with change direction
• Fastest Growing Competitor - Which competitor is growing fastest and their growth rate
• Closest Competitor - Which competitor is nearest to you by download count, and the gap

This section requires at least 30 days of data to display. Until then, it shows an “Insufficient history” message.

​

AI Visibility vs Adoption Correlation

This chart overlays your AI search visibility metrics (Presence Rate, Share of Voice, Sentiment) with your adoption data (downloads) over time. It also displays Pearson correlation coefficients for each visibility metric. This helps answer questions like:

• Does improved AI visibility lead to more downloads?
• Is there a lag between visibility changes and adoption changes?
• Which visibility metric correlates most strongly with adoption?

Note: This section only appears if you have both AI search tracking data and adoption data for the same time period.

​

Code Repositories

If you have GitHub repositories configured as domains, this section displays:

​

GitHub Stars Trend

A multi-line area chart showing GitHub stars over time for your repositories and competitors. Your primary repository is highlighted in green; competitors appear in contrasting colors.

​

Leaderboard

A sortable table comparing all tracked repositories: Click any column header to sort. Your primary repository is marked with a star icon.

​

Package Registries

If you have package registry URLs configured as domains, this section displays:

​

Weekly Downloads Trend

A multi-line area chart showing weekly download counts over time. Data is smoothed with a 28-day rolling average to reduce noise. Your primary package is highlighted; competitors appear in different colors.

​

Market Share Trend

A multi-line chart showing each package’s percentage of total tracked downloads over time. This reveals whether you are gaining or losing ground relative to competitors.

​

Leaderboard

A sortable table comparing all tracked packages: Click any column header to sort. Your primary package is marked with a star icon.

​

Setting Up Domains

The Configure Domains button at the bottom of the dashboard links to your project’s Search Tracking configuration. To add or modify tracked packages and repositories:

1. Go to your project’s Search Tracking Config
2. Select the Citation Sources tab
3. Add domains with the appropriate type:
   • GitHub repository (e.g., github.com/your-org/your-repo) for star tracking
   • Package registry (e.g., npmjs.com/package/your-package, pypi.org/project/your-package) for download tracking
4. Assign each domain to a brand (your primary brand or a competitor brand)

Data collection begins automatically after domains are added. Historical data (up to one year for npm) is backfilled when a new package is first configured.

​

Best Practices

​

Choose Meaningful Competitors

Track competitors that your users actually consider as alternatives. Tracking too many or irrelevant competitors dilutes the usefulness of market share and ranking metrics.

​

Review Regularly

• Weekly - Check summary stats and competitor movement for short-term shifts
• Monthly - Review health score trends and download growth rates
• Quarterly - Analyze longer-term market share trends and correlation data

​

Combine with AI Visibility Data

Use the AI Visibility vs Adoption Correlation chart to validate whether your content strategy improvements are translating into adoption. Strong positive correlation between presence rate and downloads suggests your AI visibility efforts are working.

​

Next Steps

• Adoption Tracking Overview - Understand the feature and key concepts
• Citation Sources - Configure the domains that feed adoption data
• Search Analytics - Explore your AI visibility data alongside adoption