SurfSense/.cursor/skills/rank-tracker/references/tracking-setup-guide.md
DESKTOP-RTLN3BA\$punk 7ea840dbb2
Some checks failed
Build and Push Docker Images / tag_release (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_backend, ./surfsense_backend/Dockerfile, backend, surfsense-backend, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-24.04-arm, linux/arm64, arm64) (push) Has been cancelled
Build and Push Docker Images / build (./surfsense_web, ./surfsense_web/Dockerfile, web, surfsense-web, ubuntu-latest, linux/amd64, amd64) (push) Has been cancelled
Build and Push Docker Images / create_manifest (backend, surfsense-backend) (push) Has been cancelled
Build and Push Docker Images / create_manifest (web, surfsense-web) (push) Has been cancelled
feat: enhance SurfSense with new skills, blog section, and improve SEO metadata
- Added multiple new skills to skills-lock.json from the repository `aaron-he-zhu/seo-geo-claude-skills`.
- Introduced `fuzzy-search` dependency in package.json for improved search functionality.
- Updated pnpm-lock.yaml to include the new `fuzzy-search` package.
- Enhanced SEO metadata across various pages, including canonical links and descriptions for better search visibility.
- Improved layout and structure of several components, including the homepage and changelog, to enhance user experience.
2026-04-11 23:38:12 -07:00

329 lines
14 KiB
Markdown

# Rank Tracking Setup Guide
Comprehensive reference for configuring rank tracking systems. Covers tool configuration, keyword selection, grouping strategies, alert thresholds, reporting cadences, and data interpretation.
---
## 1. Tracking Tool Configuration
### Initial Setup Checklist
| Step | Action | Notes |
|------|--------|-------|
| 1 | Select tracking tool | ~~SEO tool with rank tracking capability |
| 2 | Add target domain | Primary domain + any subdomains |
| 3 | Set tracking location | Country, state/region, or city level |
| 4 | Configure device settings | Mobile, desktop, or both (recommended: both) |
| 5 | Set search engine | Google (primary), Bing (optional), local engines |
| 6 | Set language | Match target audience language |
| 7 | Configure update frequency | Daily for priority keywords, weekly for long-tail |
| 8 | Add competitor domains | 3-5 direct competitors |
| 9 | Import keyword list | From keyword research or existing tracking |
| 10 | Verify initial data pull | Confirm positions match manual spot checks |
### Location Configuration
Rank tracking results vary dramatically by location. Configure tracking to match your actual target market.
| Scenario | Location Setting | Example |
|----------|-----------------|---------|
| National business | Country level | United States |
| Regional business | State/region level | California, US |
| Local business | City level | San Francisco, CA, US |
| Multi-location | Separate project per location | NYC + LA + Chicago |
| International | Separate project per country | US + UK + Canada |
**Common mistake**: Tracking from a single location when your audience is distributed. If you serve multiple cities, track key terms in each city separately.
### Device Configuration
| Device | When to Track | Why |
|--------|--------------|-----|
| Desktop | Always | Baseline reference, still significant traffic |
| Mobile | Always | 60%+ of searches are mobile; rankings differ from desktop |
| Both separately | Recommended | Identify device-specific ranking issues |
| Tablet | Optional | Usually mirrors desktop closely |
### Update Frequency Recommendations
| Keyword Tier | Frequency | Rationale |
|-------------|-----------|-----------|
| Top 20 revenue keywords | Daily | Catch drops immediately |
| Brand keywords | Daily | Protect brand presence |
| Page 1 keywords (21-50) | 2-3x per week | Monitor competitive positions |
| Page 2 keywords (51-100) | Weekly | Track progress without excessive API usage |
| Long-tail / monitoring (100+) | Weekly | Cost-efficient tracking |
| New/experimental keywords | Daily for first 30 days, then adjust | Establish baseline quickly |
---
## 2. Keyword Selection for Tracking
### How Many Keywords to Track
| Site Size | Recommended Keywords | Breakdown |
|-----------|---------------------|-----------|
| Small (< 50 pages) | 50-100 | 10 brand + 20 primary + 20 secondary + rest long-tail |
| Medium (50-500 pages) | 100-500 | 20 brand + 50 primary + 100 secondary + rest long-tail |
| Large (500+ pages) | 500-2000+ | Scale proportionally; focus on revenue pages |
| Enterprise | 2000-10000+ | Comprehensive coverage with automated management |
### Keyword Selection Criteria
Select keywords for tracking based on these factors:
| Factor | Weight | Selection Rule |
|--------|--------|---------------|
| Revenue impact | High | Always track keywords that drive conversions |
| Search volume | Medium | Track keywords with meaningful volume for your niche |
| Current ranking | Medium | Track keywords where you rank (pages 1-3) plus targets |
| Competitive value | Medium | Track keywords your competitors target |
| Strategic importance | High | Track keywords aligned with business goals |
| Content investment | Medium | Track keywords for pages you invested in creating |
### Keyword Types to Include
| Type | % of Tracked Keywords | Examples |
|------|----------------------|---------|
| Brand keywords | 5-10% | "[brand name]", "[brand] + product", "[brand] reviews" |
| Primary commercial | 15-25% | "[product category]", "best [product]", "buy [product]" |
| Secondary commercial | 15-25% | "[product] for [use case]", "[product] vs [competitor]" |
| Informational | 20-30% | "how to [topic]", "what is [concept]", "[topic] guide" |
| Long-tail | 15-25% | Specific queries with 3+ words, lower volume |
| Local (if applicable) | 5-10% | "[service] near me", "[service] in [city]" |
### Keywords You Should NOT Track
| Skip These | Why |
|-----------|-----|
| Zero-volume keywords (unless strategic) | No measurable impact |
| Keywords you have no content for | Track only when you create targeting content |
| Extremely broad single-word terms | Too volatile, hard to rank, misleading data |
| Misspellings (unless significant volume) | Clutters reporting |
---
## 3. Keyword Grouping Strategies
Effective grouping transforms raw keyword data into strategic insights.
### Grouping Dimensions
| Dimension | Examples | Insight Gained |
|-----------|---------|----------------|
| **Topic cluster** | "email marketing", "email automation", "email templates" | Content hub performance |
| **Search intent** | Informational, commercial, transactional, navigational | Funnel stage performance |
| **Funnel stage** | Awareness, consideration, decision, retention | Buyer journey alignment |
| **Product/service** | Product A, Product B, Service C | Product line performance |
| **Content type** | Blog, landing page, product page, guide | Format effectiveness |
| **Priority tier** | Tier 1 (revenue), Tier 2 (growth), Tier 3 (monitor) | Resource allocation |
| **Page** | URL-level grouping | Page-specific performance |
| **Competitor overlap** | Keywords where you compete with specific rivals | Competitive intelligence |
### Recommended Group Hierarchy
```
Level 1: Business Unit / Product Line
└── Level 2: Topic Cluster / Category
└── Level 3: Search Intent
└── Level 4: Priority Tier
```
**Example:**
```
SaaS Product
└── Project Management
└── Commercial Intent
└── Tier 1: "project management software", "best PM tools"
└── Tier 2: "PM software for small teams", "agile PM tools"
└── Informational Intent
└── Tier 1: "what is project management", "PM methodologies"
└── Collaboration
└── Commercial Intent
└── Tier 1: "team collaboration software", "best collab tools"
```
### Group Naming Conventions
Use consistent, descriptive names:
| Pattern | Example | Benefit |
|---------|---------|---------|
| `[Category] - [Intent]` | "Email Marketing - Commercial" | Clear context |
| `[Product] / [Feature]` | "CRM / Lead Scoring" | Product-line clarity |
| `T1: [Topic]` | "T1: Core Product Terms" | Priority at a glance |
---
## 4. Alert Threshold Configuration
### Setting Baseline Thresholds
Before setting alerts, establish a baseline by tracking for 2-4 weeks without alerts to understand normal fluctuation ranges.
| Metric | Baseline Period | Normal Fluctuation | Alert When |
|--------|----------------|-------------------|------------|
| Individual keyword position | 2-4 weeks | +/- 2-3 positions | Exceeds normal range |
| Average position (all keywords) | 4 weeks | +/- 1-2 positions | Exceeds normal range |
| Keywords in top 10 | 4 weeks | +/- 5% | Drops >10% |
| Keywords in top 3 | 4 weeks | +/- 3% | Drops >5% |
### Alert Configuration by Keyword Tier
| Keyword Tier | Drop Alert | Gain Alert | Competitor Alert |
|-------------|-----------|-----------|-----------------|
| Tier 1 (revenue) | Drop >= 3 positions | Gain >= 3 positions | Competitor enters top 5 |
| Tier 2 (growth) | Drop >= 5 positions | Enters top 10 | Competitor overtakes you |
| Tier 3 (monitor) | Drop >= 10 positions | Enters top 20 | None |
| Brand | Any drop from #1 | N/A | Competitor ranks for your brand |
### Alert Delivery Preferences
| Alert Type | Channel | Frequency |
|-----------|---------|-----------|
| Critical drops (Tier 1) | Email + Slack | Immediate |
| Significant changes | Email | Daily digest |
| Weekly summary | Email | Every Monday |
| Monthly report | Email + dashboard | 1st of month |
---
## 5. Reporting Cadences
### Recommended Report Schedule
| Report Type | Audience | Frequency | Key Metrics |
|------------|----------|-----------|-------------|
| Quick pulse | SEO team | Daily | Major movements, alerts fired |
| Weekly summary | Marketing team | Weekly | Position changes, trends, actions taken |
| Monthly report | Stakeholders | Monthly | Full performance analysis, MoM comparisons |
| Quarterly review | Leadership | Quarterly | Strategic trends, ROI, competitive position |
| Annual review | Executive | Annually | YoY growth, strategic recommendations |
### Report Content by Cadence
**Daily Pulse (1-2 minutes to review):**
- Keywords with biggest position changes
- Alerts triggered
- Competitor movements
**Weekly Summary (5-10 minutes to review):**
- Position distribution changes
- Top 5 improvements and declines
- SERP feature wins/losses
- AI citation changes
- Week-over-week trend
**Monthly Report (15-30 minutes to review):**
- Full position distribution analysis
- Month-over-month trends
- Competitor share of voice
- SERP feature ownership
- GEO visibility trends
- Content performance by keyword group
- Recommendations for next month
**Quarterly Review (30-60 minutes to review):**
- Quarter-over-quarter trends
- Progress against annual goals
- Competitive landscape shifts
- Strategic keyword opportunities
- Budget and resource recommendations
---
## 6. Data Interpretation Guidelines
### Understanding Rank Fluctuations
| Pattern | Meaning | Action |
|---------|---------|--------|
| Daily +/- 1-2 positions | Normal fluctuation | Ignore; track weekly trend |
| Sudden drop 5+ positions, recovers in 2-3 days | Google testing / data center variation | Monitor, no action needed |
| Steady decline over 2+ weeks | Real ranking loss | Investigate cause (see Root Cause Taxonomy) |
| Sudden drop affecting many keywords | Algorithm update or technical issue | Check Search Status Dashboard + technical health |
| One keyword drops, others stable | Page-specific or competitor-specific issue | Analyze that specific SERP |
| All keywords for one URL drop | Page-level issue (noindex, 404, slow) | Check page technical health |
| Gradual improvement over weeks | SEO efforts working | Document what worked, continue strategy |
### Position vs. Traffic Relationship
Position changes do not translate linearly to traffic changes.
| Position Change | Estimated Traffic Impact |
|----------------|------------------------|
| #1 to #2 | -50% to -60% click loss |
| #2 to #3 | -25% to -30% click loss |
| #3 to #5 | -30% to -40% click loss |
| #5 to #10 | -50% to -60% click loss |
| #10 to #11 | -60% to -80% click loss (page 2 cliff) |
| #11 to #20 | Minimal additional loss (already low) |
**Key insight**: Moving from position #10 to #11 (page 1 to page 2) has a far greater impact than moving from #20 to #30. Prioritize keeping keywords on page 1.
### Interpreting Visibility Score
Visibility score combines position and search volume into a single metric.
| Visibility Change | Interpretation |
|-------------------|---------------|
| Increasing visibility, stable positions | Seasonal search volume increase |
| Decreasing visibility, stable positions | Seasonal search volume decrease |
| Increasing visibility, improving positions | SEO strategy is working |
| Decreasing visibility, declining positions | Ranking loss causing traffic decline |
| Stable visibility, mixed position changes | Gains offsetting losses |
### Comparing Against Competitors
| Competitive Signal | Meaning | Response |
|-------------------|---------|----------|
| Competitor visibility rising, yours stable | They are gaining, you may lose ground | Analyze their strategy, accelerate efforts |
| Your visibility rising faster than competitors | You are winning share of voice | Continue strategy, identify what is working |
| All competitors dropping simultaneously | Algorithm update affecting the niche | Focus on quality, wait for dust to settle |
| One competitor surging | They made a significant change | Analyze what they did (content? links? technical?) |
### Data Quality Checks
Always verify your tracking data quality.
| Check | How | Frequency |
|-------|-----|-----------|
| Spot-check positions manually | Incognito search for 5-10 keywords | Weekly |
| Compare with Search Console | Match tracked positions with GSC average position | Monthly |
| Check for tracking errors | Look for keywords showing "not found" or position 0 | Weekly |
| Verify competitor data | Spot-check competitor rankings manually | Monthly |
| Confirm location accuracy | Search from target location (VPN if needed) | Quarterly |
---
## 7. Common Pitfalls and How to Avoid Them
| Pitfall | Problem | Solution |
|---------|---------|----------|
| Tracking too many keywords | Dilutes focus, increases cost | Focus on keywords with business impact |
| Checking rankings too frequently | Obsessing over daily noise | Focus on weekly and monthly trends |
| Not segmenting data | Averages hide important patterns | Group by intent, topic, priority |
| Ignoring SERP features | Position alone does not tell the whole story | Track featured snippets, AI Overviews, PAA |
| Not tracking competitors | Your data lacks context | Always track 3-5 competitors |
| Single location tracking | Misses local variations | Track each target market separately |
| Forgetting mobile | Mobile and desktop rankings differ | Always track both devices |
| Not documenting changes | Cannot correlate changes to actions | Log all content updates, technical changes, link building |
---
## 8. Migration and Tool Switching
If you need to switch rank tracking tools, follow this process to preserve data continuity.
| Step | Action |
|------|--------|
| 1 | Export all historical data from current tool |
| 2 | Run both tools in parallel for 2-4 weeks |
| 3 | Compare data between tools to understand differences |
| 4 | Document any systematic position differences |
| 5 | Import historical data into new tool if supported |
| 6 | Reconfigure all alerts and reports in new tool |
| 7 | Decommission old tool after confidence in new data |
**Important**: Different tools may report slightly different positions due to data center sampling, timing, and methodology. A 1-2 position variance between tools is normal.