# ShiftOps SEO Quick Reference Guide

## What Was Implemented

### 1. Enhanced Meta Tags (Lines 42-67)

```html
<!-- New meta tags added -->
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="format-detection" content="telephone=no" />
<meta name="language" content="de" />
<meta name="revisit-after" content="7 days" />
<meta name="distribution" content="global" />
<meta name="rating" content="general" />
<meta name="classification" content="Business" />
<meta name="tool-version" content="1.0" />
<meta name="tool-last-updated" content="2025-11-19" />
<meta name="update-frequency" content="weekly" />
```

### 2. Enhanced Open Graph Tags (Lines 64-71)

```html
<!-- Image optimization for social media -->
<meta property="og:image:secure_url" content="https://..." />
<meta property="og:image:width" content="1200" />
<meta property="og:image:height" content="630" />
<meta property="og:image:type" content="image/png" />
```

### 3. Enhanced WebApplication Schema (Lines 168-191)

```json
{
  "@type": "WebApplication",
  "inLanguage": "de-DE",
  "isAccessibleForFree": true,
  "keywords": "betriebsanalyse, schichtplanung, zeiterfassung...",
  "audience": {
    "@type": "BusinessAudience",
    "geographicArea": {
      "@type": "Place",
      "name": "Deutschland, Österreich, Schweiz"
    },
    "requiredMinAge": 18,
    "audienceSize": {
      "@type": "QuantitativeValue",
      "value": "50+"
    }
  }
}
```

### 4. Semantic HTML Improvements

```html
<!-- Search container -->
<div class="search-container" role="search">
  <input aria-label="Betrieb suchen" aria-describedby="search-description" />
</div>

<!-- FAQ section -->
<section itemscope itemtype="https://schema.org/FAQPage">
  <details
    itemscope
    itemprop="mainEntity"
    itemtype="https://schema.org/Question"
    role="listitem"
  >
    <summary aria-label="Was ist ShiftOps?">
      <span itemprop="name">Was ist ShiftOps?</span>
    </summary>
  </details>
</section>
```

### 5. Strategic Internal Links

- **/dienstplan** - "Personalplanung" in Restaurants section
- **/arbeitszeiterfassung** - "Personalbedarfsplanung" in Einzelhandel section
- **/arbeitszeitgesetz** - "Arbeitszeitgesetz-Konformität" in Compliance section

---

## Testing Commands

### Run Full SEO Test Suite

```bash
python3 scripts/test-shiftops-seo.py http://localhost:8003/shiftops
```

### Check Specific Elements

```bash
# Verify schema markup
curl -s http://localhost:8003/shiftops | grep -o 'application/ld+json' | wc -l

# Count visible content
curl -s http://localhost:8003/shiftops | grep -o '<main' | wc -l

# Check internal links
curl -s http://localhost:8003/shiftops | grep -o 'href="/schichtplan\|href="/zeiterfassung' | wc -l
```

---

## Validation URLs

### Schema & Rich Results

- **Google Rich Results Test:** https://search.google.com/test/rich-results
  - Input: `https://www.ordio.com/shiftops`
  - Expected: FAQPage, HowTo, WebApplication valid

### Social Media Previews

- **Facebook Debugger:** https://developers.facebook.com/tools/debug/

  - Input: `https://www.ordio.com/shiftops`
  - Expected: 1200x630 image, proper title/description

- **Twitter Card Validator:** https://cards-dev.twitter.com/validator
  - Input: `https://www.ordio.com/shiftops`
  - Expected: summary_large_image card type

### Performance & Mobile

- **PageSpeed Insights:** https://pagespeed.web.dev/

  - Input: `https://www.ordio.com/shiftops`
  - Target: >90 score for both mobile and desktop

- **Mobile-Friendly Test:** https://search.google.com/test/mobile-friendly
  - Input: `https://www.ordio.com/shiftops`
  - Expected: Pass

---

## Monitoring Setup

### Google Search Console

1. **Add Property:** https://www.ordio.com
2. **Request Indexing:**

   - Go to URL Inspection
   - Enter: https://www.ordio.com/shiftops
   - Click "Request Indexing"

3. **Set Up Monitoring:**
   - Performance → Filter by page: `/shiftops`
   - Track: Impressions, Clicks, CTR, Position
   - Set up weekly email reports

### Keywords to Track

Primary:

- "betriebsanalyse"
- "betriebsanalyse kostenlos"
- "schichtplanung analyse"
- "zeiterfassung analyse"
- "compliance check kostenlos"

Secondary:

- "shiftops"
- "restaurant analyse tool"
- "einzelhandel personalplanung"
- "hotel schichtplanung optimierung"

### AI Engine Monitoring

Test citations monthly:

- **ChatGPT:** "Was ist das beste Tool für Betriebsanalyse in Restaurants?"
- **Perplexity:** "kostenlose betriebsanalyse tools für schichtbetriebe"
- **Google Gemini:** "schichtplanung analyse kostenlos"

---

## Expected Results Timeline

### Week 1-2

- [x] Deployment complete
- [ ] Schema validated in Rich Results Test
- [ ] Initial re-crawl by Google
- [ ] Search Console shows updated snapshot

### Week 3-4

- [ ] First impressions appear
- [ ] Initial keyword rankings
- [ ] FAQ rich results may appear

### Month 2-3

- [ ] Impressions increase (target: 500-1000/month)
- [ ] CTR stabilizes (target: 3-5%)
- [ ] Rich results established
- [ ] Keyword rankings improve

### Month 4-6

- [ ] Organic traffic established
- [ ] AI citations begin appearing
- [ ] Social shares increase
- [ ] Baseline performance for scaling

---

## Troubleshooting

### Issue: No Impressions After 2 Weeks

**Solutions:**

1. Verify URL in Google Search Console
2. Request manual indexing
3. Check robots.txt isn't blocking
4. Submit XML sitemap with URL

### Issue: Schema Validation Errors

**Solutions:**

1. Test with: https://validator.schema.org/
2. Check JSON-LD syntax with: https://jsonlint.com/
3. Verify all required properties present
4. Ensure proper escaping in PHP

### Issue: Low CTR Despite Impressions

**Solutions:**

1. A/B test meta descriptions
2. Improve title tag (add year, "kostenlos", urgency)
3. Target more specific long-tail keywords
4. Add review schema if available

### Issue: No Rich Results

**Solutions:**

1. Verify schema with Rich Results Test
2. Ensure FAQ has minimum 2 questions
3. Check HowTo has minimum 2 steps
4. Wait 2-4 weeks for Google to recognize

---

## Quick Wins

### Immediate (Do Today)

- [ ] Run validation tests
- [ ] Submit URL to Search Console
- [ ] Test social media previews
- [ ] Verify mobile rendering

### This Week

- [ ] Request re-indexing in Search Console
- [ ] Set up performance monitoring
- [ ] Test with all validators
- [ ] Create tracking spreadsheet

### This Month

- [ ] Monitor keyword rankings weekly
- [ ] Track impression growth
- [ ] Test AI engine citations
- [ ] Analyze user behavior from organic traffic

---

## Files Reference

### Primary Implementation

- `v2/pages/shiftops.php` - Main page file

### Testing & Documentation

- `scripts/test-shiftops-seo.py` - Automated testing script
- `SHIFTOPS_SEO_VALIDATION_REPORT.md` - Detailed validation report
- `docs/SHIFTOPS_SEO_MONITORING_GUIDE.md` - Monitoring procedures
- `.cursor/rules/tools-pages-reference.mdc` - Pattern documentation

### Related Pages

- `v2/pages/tools_arbeitstage_rechner.php` - Similar tool page patterns
- `v2/pages/tools_industrieminuten_rechner.php` - Additional reference

---

## Key Metrics Dashboard

Create a simple tracking spreadsheet:

| Metric       | Week 1 | Week 2 | Week 3 | Week 4 | Target  |
| ------------ | ------ | ------ | ------ | ------ | ------- |
| Impressions  | -      | -      | -      | -      | 1000/mo |
| Clicks       | -      | -      | -      | -      | 30/mo   |
| CTR          | -      | -      | -      | -      | 3-5%    |
| Avg Position | -      | -      | -      | -      | <20     |
| Rich Results | -      | -      | -      | -      | Yes     |

---

## Support & Resources

### Official Documentation

- Schema.org: https://schema.org/WebApplication
- Google Search Central: https://developers.google.com/search
- Open Graph Protocol: https://ogp.me/

### Testing Tools

- Google Rich Results Test: https://search.google.com/test/rich-results
- Schema Validator: https://validator.schema.org/
- PageSpeed Insights: https://pagespeed.web.dev/

### Community Resources

- Google Search Central Help: https://support.google.com/webmasters
- Stack Overflow [schema.org]: https://stackoverflow.com/questions/tagged/schema.org

---

**Last Updated:** November 2025  
**Date:** 2025-11-20  
**Version:** 1.0  
**Status:** ✅ Production Ready