mirror of
https://github.com/MODSetter/SurfSense.git
synced 2026-04-29 19:06:24 +02:00
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
- 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.
329 lines
14 KiB
Markdown
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.
|