> For the complete documentation index, see [llms.txt](https://docs.hubyte.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubyte.de/seo-ultimate/seo-analyse.md).

# SEO-Analyse

Wertet den SEO-Zustand deines Shops aus und zeigt die Ergebnisse übersichtlich in Cards mit Kennzahlen und verlinkten Detail-Listen.

Aufruf: **Marketing → SEO Ultimate → SEO-Analyse**

## Analyse starten

* Über den Button **„Jetzt analysieren"** (oben rechts) wird eine neue Auswertung gestartet.
* Die Analyse läuft **asynchron im Hintergrund** (Shopware Message-Queue). Die Ergebnisse werden automatisch aktualisiert, sobald der Lauf fertig ist.
* Angezeigt wird immer die **zuletzt abgeschlossene** Auswertung inkl. Zeitstempel.

> **Voraussetzung:** Ein laufender **Message-Consumer / Worker** auf dem Server (bei Produktivsystemen üblicherweise bereits eingerichtet). Ohne Worker wird die angestoßene Analyse nicht verarbeitet. Alternativ täglich automatisch per [Scheduled Task](#automatisierung).

## Sprache

Metadaten und Bild-Alt-Texte sind in Shopware **übersetzbar**. Die Analyse wertet daher **jede Storefront-Sprache** (aus den Verkaufskanal-Domains) einzeln aus.

* Gibt es mehr als eine Sprache, erscheint oben eine **Sprachauswahl**.
* Standardmäßig wird die Sprache mit den meisten gepflegten Metadaten vorausgewählt.

## Metadaten-Übersicht (Artikel & Kategorien)

Je eine eigene Card für **Artikel** und **Kategorien** mit Kennzahlen:

* **Gesamt**, **Meta-Titel leer**, **Meta-Description leer**, **Titel zu lang**, **Description zu lang**.
* Als „zu lang" gilt alles über den in der [Konfiguration](#konfiguration) hinterlegten Schwellwerten (Standard: **60** Zeichen Titel, **160** Zeichen Description).

Darunter zwei Listen:

* **Probleme** – Einträge mit leeren oder zu langen Metadaten.
* **Gesetzte Metadaten (Zeichenanzahl)** – Übersicht der bereits gepflegten Einträge zur Kontrolle der Zeichenanzahl. Die Länge wird farbig dargestellt: **grün** = im gültigen Bereich, **rot** = leer oder über dem Schwellwert.

Jeder Name ist **direkt verlinkt** und öffnet den Artikel bzw. die Kategorie im Admin. Die Listen sind wie im Shopware-Standard **paginiert** (Einträge pro Seite per Dropdown wählbar).

## Bilder

* **Medien ohne Alt-Attribut** – Bilder ohne gepflegten Alt-Text. Wird ein Bild von einem Produkt verwendet, ist die Zeile **direkt zum Produkt verlinkt**.
* **Bilder ohne Src-Attribut** – `<img>`-Tags im gerenderten Storefront-HTML ohne `src` (z. B. reine Lazy-Load-Bilder mit `data-src`). Mit Link zur betroffenen Seite.

## HTTP-Fehler (Sitemap-Crawl)

Die Analyse ruft die **Sitemap-URLs** aller aktiven Verkaufskanal-Domains ab und prüft die HTTP-Statuscodes:

* **404-Fehler** (Seite nicht gefunden)
* **500er-Fehler** (Serverfehler)
* **Nicht erreichbar** (Timeout / Verbindungsfehler)

Alle Treffer werden mit URL aufgelistet. Die Anzahl der gecrawlten URLs ist über die [Konfiguration](#konfiguration) begrenzt.

## Performance

Aus demselben Crawl werden nützliche Performance-Werte ermittelt (keine externe API nötig):

* **Ø Ladezeit**, **Median Ladezeit**, **langsamste Seite** (Server-Antwortzeit)
* **Ø Seitengröße** (Übertragungsgröße)
* Liste der **langsamsten Seiten** mit Ladezeit und Größe.

## Cards auf dem Admin-Dashboard anzeigen

Jede Card hat oben rechts einen Schalter **„Auf Admin-Dashboard anzeigen"**. Ist er aktiv, erscheint die jeweilige Card (als kompakte Kennzahlen-Übersicht) direkt auf dem **Shopware-Start-Dashboard** – mit Link zur vollständigen SEO-Analyse.

> Die Einstellung gilt **shopweit** (nicht pro Benutzer).

## Konfiguration

Unter **Einstellungen → Plugins → SEO Ultimate**:

* **Meta Title Zeichen** / **Meta Description Zeichen** – Schwellwerte für die Zeichenzähler (grün/rot).
* **Max. gecrawlte URLs pro Analyse** – Obergrenze der beim Crawl abgerufenen Sitemap-URLs (Standard **300**). Höhere Werte erhöhen die Abdeckung, dauern aber länger.

## Automatisierung

Die Analyse läuft zusätzlich **einmal täglich automatisch** über Shopwares Scheduled-Task-System (`hueb_seo.analysis`).

Manuell auslösen (für Admins/Entwickler):

```bash
bin/console scheduled-task:run-single hueb_seo.analysis
```

Registrierung (falls der Task nach einem Update fehlt):

```bash
bin/console scheduled-task:register
```

## Hinweise

* **PageSpeed:** Eine Anbindung an Google PageSpeed Insights ist aktuell **nicht** enthalten; die Performance-Werte stammen aus dem eigenen Crawl.
* **Umfang:** Die Detail-Listen sind pro Auswertung begrenzt; die Kennzahlen (Gesamtzahlen) sind vollständig.
* **Sitemap:** Der Crawl setzt eine erreichbare `sitemap.xml` je Domain voraus (Shopware generiert diese automatisch; Shopware liefert die Teil-Sitemaps gzip-komprimiert aus, was die Analyse berücksichtigt).