1. WAS DIESES MODUL LEISTET - UND WARUM

Suchmaschinenoptimierung scheitert in der Praxis selten am Wissen, sondern an der Umsetzung: Man weiß, dass Meta-Titel, interne Links oder strukturierte Daten wichtig sind - aber im Alltag fehlt die Zeit, hunderte Produkte durchzugehen und zu wissen, womit man anfängt.

Genau hier setzt M0154 an. Das Modul prüft den Shop in über 50 Dimensionen, zeigt jeden Befund als Kachel mit einer Trefferliste und - wo es fachlich sinnvoll ist - mit einer Korrekturmöglichkeit direkt im modalen Fenster. Sie müssen den Shop dafür nicht verlassen und keine externen Dienste bemühen.

Das Besondere: Das Modul urteilt nicht nur, es erklärt. Jede Kachel trägt einen Info-Text, der sagt, WARUM ein Befund zählt und was er den Shop kostet, wenn man ihn ignoriert. Dieses Handbuch führt diesen Gedanken fort - es soll Sie in die Lage versetzen, Ihr SEO wirklich zu verstehen, nicht nur das Modul zu bedienen.

Wichtiger HINWEIS!
Wenn Sie das Modul "SEO-Suite" über seinen Menüpunkt aufrufen, kann es bis zur Erstanzeige einen Moment dauern. Das Modul führt beim Start zahlreiche Datenprüfungen, Verifikationen und Messungen durch. Weitere besonders intensive Messungen finden nach der Erstanzeige der Seite im Hintergrund statt. Kachel mit drei pulsierenden Punkten arbeiten noch im Hintergrund, das Messungsergebnis wird nach Abschluss des Vorgangs eingeblendet. Wenn Sie vom Modul gemeldete Probleme bearbeitet haben und auf die Hauptansicht zurückkehren, dann dauert es einen Moment, bis das Modul die dazugehörige Kachel neu durchmisst und die ggf. erfolgte Änderung anzeigt!

2. SEO UND GEO: DIE ZWEI ZIELE

SEO (Search Engine Optimization) ist das klassische Ziel: In der Google-Suche gut gefunden werden. Darum dreht sich der größte Teil des Moduls - Metadaten, Inhalte, interne Verlinkung, Indexierung, strukturierte Daten, Ladezeit.

GEO (Generative Engine Optimization) ist das neue Ziel. Suchen findet zunehmend in KI-Antworten statt: Jemand fragt ChatGPT, Perplexity oder Google (mit KI-Overviews) nach einem Produkt und bekommt eine fertige Antwort mit Quellenlinks - ohne je eine klassische Ergebnisliste zu sehen. Ob Ihr Shop in solchen Antworten vorkommt, entscheidet sich an anderen Stellen: an sichtbarem, zitierfähigem Text (Produkt-FAQ), an der Steuerung, welche KI-Crawler den Shop lesen dürfen, und an der llms.txt als Orientierung für Sprachmodelle.

M0154 deckt beide Ziele in einem Werkzeug ab. Das ist der eigentliche Kern des Moduls: klassische Suchmaschinenoptimierung UND die Vorbereitung auf die KI-gestützte Suche.

3. SO BEDIENEN SIE DIE SEO-SUITE

Kacheln und Trefferlisten Das Dashboard zeigt jede Prüfung als Kachel, gruppiert nach Dringlichkeit (kritisch / hoch / mittel / erledigt) mit der jeweiligen Trefferzahl. Ein Klick öffnet die Trefferliste in einem modalen Fenster. Das Fragezeichen an jeder Kachel öffnet den ausführlichen Info-Text.

Korrektur direkt im Modal Wo eine gezielte Korrektur möglich ist - etwa ein fehlender Meta-Titel, ein Produktkennzeichen oder die Rechte einer Kundengruppe -, bearbeiten Sie den Wert direkt im modalen Fenster und speichern. Die Zeile verschwindet aus der Liste, sobald der Befund behoben ist. Wo eine Korrektur nur im Gambio-Stammdatensatz sinnvoll ist, springt ein Link in den passenden Admin-Tab.

Sprache und Datenbasis (oben) Zwei Auswahlfelder steuern ALLE Kacheln und Listen: die Sprache und die Datenbasis (nur aktive oder alle Datensätze). Fast jede Prüfung ist sprachabhängig - ein fehlender Meta-Titel kann in Deutsch vorhanden und in Englisch leer sein. Wählen Sie die Sprache, in der Sie gerade arbeiten. Auch inaktive Sprachen lassen sich hier gezielt für die Vorbereitung auswählen.

Alle Meldungen sind modale Fenster - es gibt keine harten Browser-Dialoge.

4. DIE PRIORISIERTE ARBEITSLISTE - WOMIT FANGE ICH AN?

Das ist die wichtigste Kachel des Moduls, weil sie die erste Frage jeder SEO-Arbeit beantwortet: Womit fange ich an?

Sie bündelt alle Befunde, die sich eindeutig einer Seite zuordnen lassen, und gewichtet sie mit den Impressionen aus der Google Search Console. Eine Seite mit drei Mängeln und

5.000 Impressionen steht damit vor einer Seite mit einem Mangel und 12 Impressionen. Die

Sichtbarkeit geht bewusst gedämpft ein, damit einzelne Ausreißer die Liste nicht dominieren.

Ohne Search-Console-Import funktioniert die Liste weiterhin, sortiert dann aber nur nach Schwere und Anzahl der Befunde. Sammelbefunde wie Duplikatcluster oder Redirect-Ketten bleiben außen vor, weil sie mehrere Seiten gleichzeitig betreffen und die Gewichtung verfälschen würden.

Empfehlung: Arbeiten Sie diese Liste von oben nach unten ab. Sie investieren Ihre Zeit damit garantiert dort, wo sie den größten Effekt hat.

5. DIE PRÜFBEREICHE IM DETAIL (MIT BEGRÜNDUNG)

5.1 META-TITEL, META-DESCRIPTIONS UND DAS SUCHERGEBNIS-SNIPPET

Der Meta-Titel und die Meta-Description sind das, was ein Nutzer im Suchergebnis zuerst sieht - das "Schaufenster" Ihrer Seite. Fehlt der Titel, baut Google ihn notdürftig aus dem Seitentext, was oft beliebig wirkt. Fehlt die Description, entsteht ein zufälliges Snippet, das selten sauber zum Angebot passt.

Das Modul prüft: fehlende und doppelte Titel/Descriptions sowie deren Qualität (zu kurz, zu lang, zu generisch). Die Länge wird dabei in PIXELN gemessen, nicht in Zeichen - denn genau so misst auch Google, und ein "W" ist breiter als ein "i". Die SERP-Snippet-Vorschau zeigt, ob Titel und Description im sichtbaren Bereich vollständig lesbar bleiben oder abgeschnitten werden. Als grober Richtwert schneidet Google Titel oberhalb von etwa 580 Pixeln (Desktop) ab.

Doppelte Titel sind heikel, weil Google dann schwerer erkennt, welche Seite für welches Thema ranken soll. Ziel sind je Seite klar unterscheidbare, thematisch passende Angaben.

5.2 INHALTE UND TEXTQUALITÄT

Suchmaschinen und Nutzer brauchen genug Substanz, um Thema und Nutzen einer Seite zu erkennen. Das Modul findet Seiten mit auffällig wenig Text, Seiten ganz ohne zusammenhängenden Fließtext (nur Listen, Teaser oder Bilder), Duplicate Content (identische Haupttexte über mehrere Seiten) und Near-Duplicates (sehr ähnliche, aber nicht identische Texte). Beides kann Rankings aufsplitten und Seiten austauschbar wirken lassen.

Ein Sonderfall sind Kategorieseiten mit vielen Produkten, aber dünnem Beschreibungstext (Thin-Category-Check). Gerade stark belegte Kategorien ohne tragfähigen Text wirken beliebig - dabei sind sie oft die wichtigsten Landingpages des Shops.

Die Überschriften-Struktur wird ebenfalls geprüft: unlogische Sprünge (z. B. von H2 direkt auf H4) oder doppelte H1 erschweren Lesern, Screenreadern und Suchmaschinen die Orientierung.

5.3 INTERNE VERLINKUNG

Interne Links sind der am meisten unterschätzte SEO-Hebel: Sie kosten nichts, führen Besucher weiter und verteilen die Autorität Ihrer starken Seiten auf die, die sie brauchen.

Das Modul findet Seiten ohne interne Links im Hauptinhalt, defekte interne und externe Links (per HTTP-Status geprüft), unsichere http-Links in HTTPS-Shops (Mixed-Content) und verwaiste Seiten ohne eingehende Verlinkung.

Das Herzstück sind die internen Verlinkungsvorschläge: Das Modul findet Textstellen, die den Namen einer Kategorie ausschreiben, ohne dorthin zu verlinken. Der Klassiker - ein Text erwähnt "unsere Gambio-Templates", aber von dort führt kein Weg zur Kategorie. Der Link lässt sich mit einem Klick direkt aus der Liste einfügen.

Wichtig für Ihr Vertrauen in die Funktion: Die Einfügung fasst AUSSCHLIESSLICH die eine Textstelle an. Sie überspringt alles, was bereits verlinkt ist, rührt Attribute wie alt oder title nicht an, geht nie in Skript- oder Style-Blöcke und setzt genau ein Vorkommen - das erste. Der übrige Text bleibt Byte für Byte unverändert; auch Schreibweisen wie für oder Zeilenumbrüche bleiben so, wie Sie sie erfasst haben. Kategorienamen unter sechs Zeichen bleiben außen vor, weil kurze Wörter wie "Neu" oder "Sale" sonst überall anschlagen würden (die Grenze ist im Setup einstellbar).

5.4 BILDER, ALT-TEXTE UND LADEZEIT

Zwei Themen: Barrierefreiheit/Bildsuche und Ladezeit.

Fehlende ALT-Texte sind schlecht für Screenreader, für die Google-Bildsuche und für die inhaltliche Einordnung durch Suchmaschinen. Das Modul sammelt sie für Produkte, Kategorien und Inhalte und macht sie nacherfassbar.

Bei der Ladezeit prüft das Modul zu große Dateien und zu große Bildabmessungen sowie fehlende WebP-Ableitungen. Große Bilder verlangsamen den Seitenaufbau, besonders auf dem Handy - und das fließt über die Core Web Vitals direkt ins Ranking ein. Sehr große Bilder werden im Shop meist ohnehin heruntergerechnet und kosten dann nur Ladezeit ohne sichtbaren Nutzen.

5.5 INDEXIERUNG: CANONICAL, NOINDEX, SITEMAP, ROBOTS.TXT

Hier geht es um die Frage: Welche Seiten SOLL Google überhaupt in den Index nehmen - und stimmen die technischen Signale dazu überein?

Das Modul prüft noindex-Angaben (für Kampagnen-/Testseiten ok, für wichtige Landingpages kritisch), ungültige Canonicals und den besonders heiklen Fall, dass Canonical und noindex widersprüchlich zusammentreffen.

Der Sitemap-Abgleich ist einer der wertvollsten Bereiche. Die Sitemap ist das Verzeichnis, das der Shop bei Google einreicht ("das sind meine Seiten, bitte indexiere sie"). Gambio erzeugt sie über den Cronjob "Sitemap erstellen" und schreibt sie nach public/. Aufgenommen wird alles Aktive - ABER der Generator prüft NICHT, ob eine Seite auf noindex steht oder von der robots.txt blockiert wird. Genau daraus entstehen die beiden häufigsten Search-Console-Fehler. Das Modul prüft deshalb beide Richtungen:

• aktive, indexierbare Seiten, die in der Sitemap FEHLEN (meist ist die Sitemap schlicht älter als die Seite - ein neuer Cronjob-Lauf genügt),
• eingereichte URLs, die auf noindex stehen ("Eingereichte URL als noindex gekennzeichnet") oder per robots.txt gesperrt sind ("Durch robots.txt blockiert") - der teurere Fehler, weil der Shop sich hier selbst widerspricht,
• Produkte, die nur in DEAKTIVIERTEN Kategorien hängen und deshalb in der Sitemap fehlen, aber öffentlich erreichbar und indexierbar sind,
• Sitemap-Dateien für Sprachen, die der Shop gar nicht mehr anbietet,
• eine fehlende "Sitemap:"-Zeile in der robots.txt (ohne sie findet keine Suchmaschine die Sitemap von allein).

Beide Aktionen - Sitemap neu erzeugen und robots.txt neu erzeugen - laufen über Gambios EIGENE Generatoren. Wichtig zur robots.txt: Gambio schreibt die "Sitemap:"-Zeile selbst, aber nur, wenn die Sitemap zum Zeitpunkt der Erzeugung bereits existiert. Reihenfolge daher: erst Sitemap, dann robots.txt.

5.6 STRUKTURIERTE DATEN UND RICH RESULTS

Strukturierte Daten (JSON-LD) sagen Google, WAS auf einer Seite steht - und sind die Voraussetzung für die "schönen" Suchergebnisse mit Preis, Bewertung, Verfügbarkeit.

Google ordnet ein Angebot dem Produktkatalog über die GTIN zu (Sammelbegriff für EAN, UPC, JAN, ISBN-13) oder ersatzweise über MPN (Herstellernummer) plus Marke. Fehlt beides, kann Google das Produkt nicht sicher identifizieren, und es erscheint nicht in den kostenlosen Produkt-Listings. Die Felder gibt es im Gambio-Artikelstamm bereits; sobald sie gepflegt sind, gibt das Modul sie automatisch im Markup aus - reine Datenpflege, kein technischer Aufwand. Für Dienstleistungen oder Sonderanfertigungen gibt es schlicht keine GTIN; setzen Sie dort im Artikelstamm "Kennzeichen vorhanden" auf Nein - dann verschwinden sie aus der Liste, und Google erwartet dort auch keines mehr.

Ergänzend gibt das Modul auf der Startseite Organisationsdaten (Name, Logo, E-Mail) und die Sitelinks-Suchbox aus sowie optional Versand- und Rückgabeangaben im Produkt-Markup, die Google direkt im Suchergebnis anzeigen kann (z. B. "Lieferung bis ..."). Diese Angaben nur aktivieren, wenn die hinterlegten Werte wirklich zum Checkout passen. WICHTIG: Wenn Sie bereits das Google-Shopping-/Export-Modul von Gambio nutzen (das Versand- und Rückgabedaten an Google übermittelt), lassen Sie die Versand- und Rückgabe-Strukturdaten des Moduls AUS - sonst erhält Google zwei möglicherweise abweichende Angaben. Beide Optionen sind standardmäßig ausgeschaltet. Zusätzlich gilt: Ist Gambios Google-Export verbunden, unterdrückt das Modul die eigenen Versand- und Rückgabe-Strukturdaten automatisch - so bleibt der Feed die eine Quelle, ganz gleich wie die Schalter stehen.

5.7 404-FEHLER UND VERLORENE RANKINGS

Das 404-Monitoring protokolliert echte Fehlaufrufe - ausgelöst von echten Besuchern und Suchmaschinen, aus alten Kampagnen, externen Links oder gelöschten Produkten. Anders als die Linkprüfungen (die nur shopinterne Verweise betrachten) fängt es also auch das ein, was von außen kommt. Jeder Treffer lässt sich per 301 auf ein sinnvolles Ziel weiterleiten.

"Verlorene Rankings" ist der teuerste stille Verlust in einem Shop: deaktivierte Produkte, deren Seite korrekt einen 404 liefert, die Google aber noch kennt und in den Ergebnissen zeigt. Jeder Treffer ist ein Ranking, das die Seite über Monate oder Jahre erarbeitet hat, samt aller eingehenden Links. Mit dem 404 wirft Google beides weg. Eine 301 auf die passende Kategorie oder ein Nachfolgeprodukt hält Position UND Linkkraft im Shop. Die Quell-URL stammt direkt aus der Search Console - also exakt die Adresse, unter der Google die Seite kennt.

5.8 SEARCH CONSOLE: ECHTE NACHFRAGE-DATEN

Die Search Console liefert die einzige echte Wahrheit darüber, wonach Menschen suchen und wo Ihr Shop bereits auftaucht. Das Modul importiert die CSV-Exporte (in der Search Console unter "Leistung", oben rechts "Exportieren"). Es unterscheidet die Suchanfragen-, Seiten- und Zeitreihen-Datei (Diagramm.csv liefert den Auswertungszeitraum) und weist darauf hin, wenn die Daten veraltet sind.

Darauf bauen mehrere Kacheln auf:

• "Fast auf Seite 1" (Striking Distance): Suchanfragen auf Position 11 bis 20 - direkt hinter Seite 1, wo praktisch alle Klicks stattfinden. Die Seite rankt bereits, sie schafft nur den letzten Schritt nicht. Ein Sprung von Position 12 auf 8 bringt in der Regel mehr als jede neue Seite, die bei null anfängt. Sortiert nach geschätztem Klick-Potenzial. Das sind die lohnendsten Treffer der ganzen Suite.
• "CTR schwach": Suchanfragen mit vielen Impressionen, brauchbarer Position, aber auffällig niedriger Klickrate - meist liegt hier ein zu allgemeiner Titel oder eine unklare Description zugrunde.
• Query-Title-Gap und Query-Kannibalisierung: wo sich die echte Suchanfrage nur schwach in Titel/URL widerspiegelt oder mehrere Seiten um dieselbe Anfrage konkurrieren.

5.9 MEHRSPRACHIGKEIT (HREFLANG)

In mehrsprachigen Shops muss jede Seite auf ihre Sprachversionen verweisen (hreflang). Fehlt das, konkurrieren die Sprachversionen derselben Seite gegeneinander, statt sich zu stärken, und Google spielt womöglich die falsche Sprache aus.

Das Modul gibt die Tags automatisch im Header aus - aber ausdrücklich nur für Sprachversionen, die es WIRKLICH gibt. Eine URL zu raten wäre schlimmer als gar kein Tag, weil Google einen Verweis auf eine nicht existierende Seite als Fehler wertet. Die zugehörige Kachel zeigt Seiten, bei denen eine Sprachversion fehlt. Sprachen lassen sich über einen Konfigwert von der hreflang-Ausgabe ausnehmen - sinnvoll für eine aktive, aber inhaltlich noch leere Testsprache.

5.10 SICHTBARKEIT JE KUNDENGRUPPE

Diese Prüfung deckt zwei Fehler auf, die beide leise passieren und beide echten Schaden anrichten.

Der erste ist ein Ausfall: Kundengruppen sind in Gambio JE SPRACHE gepflegt. Wird eine Sprache eingeschaltet, ohne die Gruppen dafür anzulegen, sucht der Shop die Kundengruppe des Besuchers in dessen Sprache, findet sie nicht - und bricht mit einem HTTP 500 ab. Betroffen sind Kategorieseiten, und zwar AUSSCHLIESSLICH für anonyme Besucher. Eingeloggt merken Sie nichts davon; Google und jeder Kunde sehen die Fehlerseite.

Der zweite ist schleichend: Legen Sie eine neue Kundengruppe an, werden deren Rechte in Artikeln, Kategorien und Inhalten NICHT automatisch mitgesetzt. Die Gruppe sieht diese Seiten dann einfach nicht - und weil Sie selbst nie in dieser Gruppe unterwegs sind, fällt es niemandem auf. Gemeldet wird bewusst nur der verdächtige Fall: eine Seite, die die MEHRHEIT der Gruppen sehen darf und ausgerechnet eine nicht. Ein Artikel nur für Händler ist eine gewollte Einschränkung und taucht nicht auf. Die Korrektur erfolgt im modalen Fenster mit einer Checkbox je Kundengruppe. Der zweite Teil greift nur, wenn der Kundengruppencheck (GROUP_CHECK) aktiv ist.

5.11 KI-CRAWLER-STEUERUNG UND LLMS.TXT (GEO)

Dies ist der GEO-Teil des Moduls. Ob Ihr Shop in KI-Antworten vorkommt, entscheidet die robots.txt. Dabei kommt es auf einen Unterschied an, den viele übersehen:

• ANTWORTBOTS (OAI-SearchBot, ChatGPT-User, PerplexityBot, Claude-User, DuckAssistBot u. a.) rufen Seiten ab, um sie in einer KI-Antwort zu ZITIEREN und zu verlinken - sie bringen Besucher, genau wie der Googlebot. Wer sie sperrt, verschwindet aus diesen Antworten. Das ist fast immer ein Versehen und wird als Befund gemeldet.
• TRAININGSBOTS (GPTBot, ClaudeBot, Google-Extended, CCBot u. a.) sammeln Inhalte fürs Modelltraining und bringen keinen einzigen Besucher. Sie zu sperren ist eine völlig legitime unternehmerische Entscheidung - das Modul zeigt den Zustand, urteilt aber nicht.

Wichtig zur Einordnung: Google-Extended betrifft NUR die KI-Nutzung (Gemini/AI Overviews), NICHT die normale Google-Suche. Es zu sperren kostet keine Rankings.

Die Regeln schreibt das Modul in die VORLAGE export/robots.txt.tpl, nicht in die robots.txt selbst - denn Gambio erzeugt die robots.txt bei jedem Speichern komplett aus dieser Vorlage neu. Nur ein Eintrag in der Vorlage überlebt das.

Geprüft wird außerdem die llms.txt - eine Kurzorientierung für Sprachmodelle, was Ihr Shop anbietet. Das Modul erzeugt sie spezifikationskonform als Markdown (Überschrift, Kurzfassung und kuratierte Link-Listen zu Sortiment, Service und häufig gesuchten Produkten). Tote oder weitergeleitete Links werden vor dem Schreiben geprüft und aussortiert.

6. DIE GEO-SUITE: KI-GESTÜTZTE TEXTE

Die GEO-Suite erzeugt Textvorschläge für Produkte, Kategorien, Inhalte und Artikelinhalte - einzeln oder als Batch, optional mit Referenz-URLs und Prompt-Kontext.

Drei Anbieter stehen zur Wahl: OpenAI, Gemini und Claude (Anthropic). Provider, Modell und API-Key werden im Modul-Setup gepflegt. Ohne Key für den aktiven Provider bleiben die KI-Funktionen inaktiv; das Dashboard zeigt dann einen deutlichen Hinweis-Banner, und jeder Generierungsversuch meldet freundlich, dass zuerst ein Schlüssel einzutragen ist.

Grundsätze:

• Die KI erzeugt Vorschläge aus dem vorhandenen Text und erfindet nichts dazu.
• Übernommen wird nur, was Sie nach Sichtung freigeben und speichern.
• Über Prompt-Regeln (global und je Bereich), Markenton und Anredeform steuern Sie den Stil zentral.

Die Produkt-FAQ ist ein GEO-Sonderfall: Sie erzeugt häufige Fragen und Antworten als SICHTBAREN Text unter der Produktbeschreibung. Das wirkt doppelt - es holt Long-Tail-Suchen ab ("ist X für Y geeignet?") und liefert Sprachmodellen genau den Text, aus dem sie ihre Antworten bauen. (Hinweis: Google hat die FAQ-Rich-Results abgeschaltet; der Wert liegt heute im sichtbaren Text, nicht im Markup.)

7. DAS MODUL-SETUP: ALLE KONFIGURATIONSWERTE IM DETAIL

Das Setup erreichen Sie im Gambio-Admin über das Modul-Center: dort den Eintrag "M0154 - Ultimative SEO-Suite" öffnen und auf "Einstellungen" gehen. Jeder Wert trägt dort einen kurzen Infotext; dieses Kapitel ordnet die Werte ausführlicher ein und nennt jeweils den Auslieferungsstandard in (Klammern). Die mit den Standardwerten ausgelieferte Konfiguration ist für die meisten Shops direkt sinnvoll - Sie müssen nichts umstellen, um loszulegen. Die Ja/Nein-Schalter werden im Setup als lesbare Auswahl angezeigt, nicht als "true/false".

7.1 GRUNDSCHALTER UND ANZEIGE

Modulstatus (Standard: Ja) Der Hauptschalter des gesamten Pakets. Steht er auf Nein, sind sowohl die Backend-Auswertungen als auch alle Frontend-Ausgaben (Strukturdaten, hreflang, FAQ, Toolbar) stillgelegt. Nützlich für eine vorübergehende komplette Deaktivierung, ohne das Modul zu deinstallieren.

SEO-Toolbar (Standard: Ja) Blendet im Shop-Frontend eine schmale Leiste mit SEO- und Social-Meta-Daten der aktuell betrachteten Seite ein. Sie ist ausschließlich für eingeloggte Administratoren sichtbar - ein normaler Besucher sieht nie etwas davon.

ALT-Text-Prüfung (Standard: Ja) Aktiviert die Analyse- und Pflegewerkzeuge für fehlende ALT-Texte an Bildern.

ALT-Text-Ergebnislimit (Standard: 50) Wie viele editierbare Treffer eine ALT-Text-Abfrage höchstens auf einmal lädt. Ein höherer Wert zeigt mehr auf einen Blick, macht das Modal aber schwerer; 50 ist ein guter Kompromiss.

404-Fehler protokollieren (Standard: Ja) Erfasst echte Fehlaufrufe von Besuchern und Suchmaschinen als Grundlage für die Weiterleitungs-Vorschläge (siehe 5.7). Ohne diese Protokollierung bleiben die Kacheln "404-Fehler" und "Verlorene Rankings" leer.

FAQ im Shop anzeigen (Standard: Ja) Zeigt die gepflegten häufigen Fragen sichtbar unter der Produktbeschreibung an (inkl. FAQ-Markup). Ist der Schalter aus, werden vorhandene FAQ weder ausgegeben noch im Markup gesetzt.

FAQ-Überschrift (Standard: leer) Überschrift des FAQ-Blocks auf der Produktseite. LEER LASSEN ist die Empfehlung: dann wird die Überschrift je Sprache automatisch passend übersetzt (z. B. "Frequently asked questions" im englischen Shop). Tragen Sie einen eigenen Text ein, gilt dieser fest für ALLE Sprachen - in einem mehrsprachigen Shop also bewusst nur nutzen, wenn Sie das so wollen.

Treffer pro Seite (Standard: 200) Steuert die Zeilenanzahl pro Seite in den Trefferlisten der SEO-Suite. Höhere Werte bedeuten weniger Blättern, aber längere Ladezeiten je Liste.

Search Console: Warnung ab (Tage) (Standard: 60) Ab diesem Alter des letzten CSV-Imports weist die Suite darauf hin, dass die Search-Console-Daten veraltet sind (siehe 5.8). Wer häufig importiert, kann den Wert senken.

7.2 SCHWELLENWERTE: META-TITEL UND DESCRIPTION (PIXEL)

Diese vier Werte werden in PIXELN gemessen, nicht in Zeichen - genau so bewertet auch Google die Länge (ein "W" ist breiter als ein "i").

SEO-Titel Mindestbreite (Standard: 300) Unterhalb dieser Breite gilt ein Seitentitel als zu kurz - er verschenkt Platz für relevante Begriffe.

SEO-Titel Maximalbreite (Standard: 580) Oberhalb dieser Breite gilt der Titel als zu lang. Um etwa 580 px schneidet Google den Titel im Suchergebnis ab (Richtwert Desktop).

SEO-Description Mindestbreite (Standard: 400) Zu kurze Beschreibungen nutzen den Platz im Snippet nicht und wirken dünn.

SEO-Description Maximalbreite (Standard: 920) Was darüber liegt, kürzt Google im Snippet mit "..."; die Kernaussage sollte davor stehen.

7.3 SCHWELLENWERTE: INHALTE UND KATEGORIETEXTE

Content-Warnschwelle Wörter (Standard: 500) Unterhalb dieser Wortzahl wird ein Inhalt als "wenig Text" markiert (siehe 5.2).

Fließtext-Block Mindestzeichen (Standard: 100) So viele Zeichen muss ein Absatz-Block (p oder div) mindestens haben, um als echter Fließtext zu zählen. Damit erkennt das Modul Seiten, die nur aus Teasern, Listen oder Bildunterschriften bestehen und keinen zusammenhängenden Text haben.

Thin-Category min. Produkte (Standard: 8) Erst ab dieser Produktanzahl wird eine Kategorie überhaupt auf dünnen Text geprüft. So bleiben kleine oder neue Kategorien außen vor, bei denen wenig Text normal ist.

Thin-Category viele Produkte (Standard: 15) Ab dieser Produktanzahl wird bei sehr wenig Text die hohe Priorität vergeben - eine stark belegte Kategorie ohne Text ist besonders schade um die Landingpage.

Thin-Category Text-Warnung (Wörter) (Standard: 220) Unterhalb dieser Wortzahl gilt der Kategorietext als dünn.

Thin-Category Text-Hoch (Wörter) (Standard: 120) Unterhalb dieser Wortzahl und bei vielen Produkten wird die hohe Priorität gesetzt.

7.4 SCHWELLENWERTE: BILDER UND LADEZEIT

Große Bilder verlangsamen den Seitenaufbau (vor allem mobil) und drücken über die Core Web Vitals das Ranking. Zwei Achsen werden getrennt bewertet: Dateigröße (KB) und Abmessung (Kantenlänge in Pixeln), jeweils mit einer Warn- und einer Hoch-Schwelle.

Bildgröße Warnung (KB) (Standard: 500) Ab dieser Dateigröße gilt ein Bild als groß.

Bildgröße Hoch (KB) (Standard: 1200) Ab dieser Dateigröße gilt ein Bild als sehr groß (hohe Priorität).

Bilddimension Warnung (px) (Standard: 2200) Ab dieser Kantenlänge gilt ein Bild als groß. Sehr große Bilder werden im Shop meist ohnehin heruntergerechnet und kosten dann nur Ladezeit ohne sichtbaren Nutzen.

Bilddimension Hoch (px) (Standard: 3000) Ab dieser Kantenlänge gilt ein Bild als sehr groß (hohe Priorität).

7.5 INTERNE VERLINKUNG

Verlinkung: Mindestlänge des Kategorienamens (Standard: 6) Kategorienamen mit weniger Zeichen werden bei den internen Verlinkungsvorschlägen (siehe 5.3) ignoriert. Kurze Wörter wie "Neu" oder "Sale" würden sonst überall im Text anschlagen und unbrauchbare Vorschläge erzeugen.

7.6 STRUKTURIERTE DATEN (GOOGLE-RICH-RESULTS)

Strukturdaten: Organization/WebSite ausgeben (Standard: Ja) Gibt auf der Startseite Organisationsangaben (Name, Logo, E-Mail) und die Sitelinks-Suchbox aus - die Grundlage dafür, dass Google Logo und Marke im Suchergebnis zeigen kann. Kann in der Regel an bleiben.

Strukturdaten: Artikelnummer als MPN nutzen (Standard: Nein) Nur einschalten, wenn in der Gambio-Artikelnummer wirklich die HERSTELLERnummer steht. Eine falsche MPN verschlechtert Googles Produktabgleich - im Zweifel aus lassen.

Strukturdaten: Versandangaben ausgeben (Standard: Nein) Ergänzt Versandkosten und Lieferzeit im Produkt-Markup, die Google direkt im Suchergebnis anzeigen kann. WICHTIG: Nutzen Sie bereits das Google-Shopping-/Export-Modul von Gambio (das Versandkosten an Google übermittelt), unterdrückt das Modul diese Ausgabe automatisch, sobald der Feed verbunden ist - der Feed bleibt dann die eine Quelle, und Sie können den Schalter gefahrlos so lassen, wie er ist. Ohne verbundenen Feed nur aktivieren, wenn die folgenden Werte exakt zum Checkout passen.

Zu dieser Ausgabe gehören:

• Versandkosten (Standard: 0.00): z. B. 4.90; 0.00 = kostenloser Versand. Muss mit dem Checkout übereinstimmen; ein abweichender Wert im Suchergebnis enttäuscht Kunden und kann von Google beanstandet werden.
• Zielland (Standard: DE): Ländercode für Versand- und Rückgabeangaben.
• Bearbeitungszeit min./max. (Tage) (Standard: 0 / 1): Zeit bis zum Versand der Bestellung.
• Laufzeit min./max. (Tage) (Standard: 1 / 3): Transportdauer des Versanddienstleisters. Bearbeitungszeit und Laufzeit ergeben zusammen die Lieferzeit, die Google als "Lieferung bis ..." anzeigen kann.

Strukturdaten: Rückgabebedingungen ausgeben (Standard: Nein) Ergänzt die Rückgabefrist im Produkt-Markup. Wie bei den Versandangaben gilt: Ist Gambios Google-Export verbunden (der die Rückgabe selbst meldet), wird diese Ausgabe automatisch unterdrückt, um doppelte oder abweichende Angaben zu vermeiden.

Zu dieser Ausgabe gehören:

• Rückgabefrist (Tage) (Standard: 14): übliche Frist.
• Rücksendekosten (Standard: Shop trägt die Kosten): "Shop trägt die Kosten" (kostenlose Rückgabe) oder "Kunde trägt die Rücksendekosten".

7.7 KI / GEO (PROVIDER, MODELLE, STIL, PROMPT-REGELN)

Diese Werte steuern die GEO-Suite (Kapitel 6). Ohne hinterlegten Key des aktiven Providers bleiben alle KI-Funktionen inaktiv (mit sichtbarem Hinweis-Banner).

KI-Provider (Standard: OpenAI) Welchen Dienst die GEO-Funktionen verwenden: OpenAI, Gemini oder Claude (Anthropic). Der Key GENAU DIESES Anbieters muss unten eingetragen sein; die Keys der übrigen Anbieter dürfen leer bleiben.

OpenAI API-Key / Gemini API-Key / Claude API-Key (Standard: jeweils leer) Die Zugangsdaten des jeweiligen Dienstes. Verwendet wird nur der Key des oben gewählten Providers.

OpenAI Modell (Standard: gpt-5.6-terra) z. B. gpt-5.6-terra (guter Kompromiss aus Qualität und Kosten) oder gpt-5.6-luna für sehr hohe Mengen.

Gemini Modell (Standard: gemini-flash-latest) Alias auf das jeweils aktuelle Flash-Modell.

Claude Modell (Standard: claude-sonnet-5) z. B. claude-sonnet-5 (guter Kompromiss aus Qualität und Kosten) oder claude-opus-4-8 für höchste Qualität.

KI-Temperatur (Standard: 0.3) Niedrige Werte liefern stabilere, sachlichere Texte; höhere Werte kreativere, variablere Formulierungen. Für Shop- und SEO-Texte sind meist 0.2 bis 0.4 sinnvoll.

KI Max Tokens (Standard: 900) Begrenzt die Länge der KI-Antwort je Generierung. Faustregel: 1 Token entspricht etwa 0,75 Wörtern - 900 Tokens sind also rund 650 Wörter. Zu niedrig schneidet Texte ab, zu hoch kostet unnötig.

Anredeform (Standard: Neutral) Standard für die Ansprache: neutral, Du-Form oder Sie-Form. "Neutral" vermeidet die direkte Anrede ganz ("Das Modell überzeugt durch ..."), "Du-Form" duzt ("Du bekommst ..."), "Sie-Form" siezt ("Sie erhalten ..."). Wählen Sie, was zur Zielgruppe Ihres Shops passt.

Markenton / Stilvorgabe (Standard: leer) Optionale globale Stilhinweise für die KI - Tonalität, Zielgruppe, No-Gos oder bevorzugte Argumentationslinien. Diese Angabe wirkt wie ein "Styleguide", der bei jeder Generierung mitgegeben wird. Beispiele, die Sie hier eintragen könnten:

• "Sachlich, technisch präzise, keine Werbefloskeln wie 'das Nonplusultra'."
• "Nachhaltigkeit und Regionalität betonen; Zielgruppe sind umweltbewusste Familien."
• "Kurze Sätze, aktive Formulierungen, maximal ein Ausrufezeichen pro Absatz."
• "Keine Superlative ohne Beleg; keine Heilversprechen bei Kosmetik."

KI Prompt-Regeln (global sowie je Bereich Produkte / Kategorien / Inhalte / Artikelinhalte) (Standard: jeweils leer) Zusätzliche Regeln, die an den Prompt angehängt werden - die globalen für ALLE Texte, die bereichsspezifischen NUR für den jeweiligen Bereich. Sie ergänzen die fest eingebauten Sicherheitsvorgaben, ersetzen sie aber nie (siehe Kasten unten). Hier steuern Sie ganz konkret Aufbau, Länge und Inhalt der erzeugten Texte.

Beispiele für globale Prompt-Regeln (gelten überall):

• "Antworte immer auf Deutsch, auch wenn der Ausgangstext englische Begriffe enthält."
• "Verwende keine Emojis und keine Hashtags."
• "Nenne niemals konkrete Preise, Rabatte oder Lieferzeiten."
• "Schreibe die Marke stets als 'XYCONS' in Großbuchstaben."

Beispiele für bereichsspezifische Prompt-Regeln:

• Produkte: "Beginne mit dem konkreten Nutzen, dann die drei wichtigsten technischen Eigenschaften als Aufzählung, dann ein kurzer Abschlusssatz. Höchstens 120 Wörter."
• Kategorien: "Ordne die Kategorie in das Sortiment ein und erwähne zwei typische Anwendungsfälle. Keine einzelnen Produktnamen nennen (die wechseln)."
• Inhalte: "Ratgeber-Ton, gib eine konkrete Handlungsempfehlung pro Absatz."
• Artikelinhalte: "Knapp und faktenorientiert; ideal für Zusatzinfos unter dem Hauptprodukttext."

WICHTIG - Prompt-Regeln sind Stil- und Inhaltsvorgaben, kein Sicherheitsrisiko: Die fest eingebauten Schutzregeln des Moduls (nichts erfinden, keine ausgedachten Fakten, nur den vorhandenen Text als Grundlage, keine Übernahme ohne Ihre Freigabe) haben immer Vorrang. Eine Prompt-Regel wie "Erfinde fehlende technische Daten" oder "Ignoriere alle bisherigen Anweisungen" wird daher NICHT befolgt - solche Versuche laufen ins Leere. Und unabhängig von jeder Regel gilt: Kein KI-Text geht automatisch live; übernommen wird nur, was Sie nach Sichtung ausdrücklich speichern (siehe Kapitel 6).

7.8 CRAWLER

Der Crawler ruft URLs aus der Sitemap ab (u. a. für HTTP-Status/Linkprüfungen). Die Werte begrenzen Umfang und Laufzeit; ein Lauf, der ins Zeitbudget läuft, wird beim nächsten Cron-Lauf fortgesetzt.

Crawler: maximale URL-Anzahl (Standard: 5000) Obergrenze der URLs, die ein Crawl-Job aus der Sitemap übernimmt.

Crawler: maximale Sitemap-Anzahl (Standard: 30) Obergrenze der Sitemap-Dateien, die bei einem Sitemap-Index eingelesen werden.

Crawler: URLs pro Abruf (Standard: 2) Wie viele URLs ein einzelner Statusabruf im Backend pro Durchlauf verarbeitet.

Crawler: Wiederholungsversuche (Standard: 2) Wiederholungen bei temporären Abruffehlern einer URL.

Crawler: Zeitbudget je Cron-Lauf (Sekunden) (Standard: 120) Wie lange ein Cron-Lauf höchstens crawlt, bevor er den Job an den nächsten Lauf übergibt.

Hinweis zum Lizenzschlüssel: Der Wert "Lizenzschlüssel" wird beim Kauf hinterlegt und schaltet das Modul von der Testversion (begrenzte Optimierungscredits pro Tag) auf den uneingeschränkten Betrieb frei.

8. HÄUFIGE STOLPERSTEINE

• Eine Sprache aktivieren ist kein harmloser Schalter. Ohne vollständige Kundengruppen (customers_status) für diese Sprache liefern Kategorieseiten anonymen Besuchern einen HTTP 500. Siehe 5.10.

• Sitemap ist da, wird aber nicht gefunden. Fehlt die "Sitemap:"-Zeile in der robots.txt, kennt nur die Search Console die Sitemap. Erst Sitemap erzeugen, dann robots.txt neu erzeugen - Gambio schreibt die Zeile nur, wenn die Sitemap bereits existiert.

• Produkte im Netz, aber unsichtbar. Produkte in einer deaktivierten Kategorie fehlen in Navigation und Sitemap, sind aber öffentlich erreichbar und indexierbar. Der Sitemap-Abgleich meldet genau das.

• Search-Console-Daten veralten. Die Werte in den Kacheln sind so aktuell wie Ihr letzter CSV-Import. Das Modul warnt ab einem einstellbaren Alter.

• Ohne API-Key keine KI. Die GEO-Funktionen brauchen einen hinterlegten Key des aktiven Providers; sonst bleiben sie inaktiv (mit sichtbarem Hinweis).
• Testversion: Beim Öffnen der SEO-Suite und jeder Trefferliste erscheint ein kurzer modaler Hinweis auf die verbleibenden Optimierungscredits des Tages und die Möglichkeit zur Lizenzierung. Nach der Lizenzierung entfällt der Hinweis vollständig.

9. TECHNISCHE REFERENZ

9.1 TABELLEN (Präfix xy_m0154_, in der Shop-Datenbank)

    xy_m0154_seo_content            modulinterne SEO-Zusatzwerte je Seitentyp/Seite/Sprache
    xy_m0154_url_keyword_history    Verlauf der URL-Keyword-Änderungen und Redirect-Kandidaten
    xy_m0154_crawl_jobs             Crawl-Jobs
    xy_m0154_crawl_job_urls         URLs je Crawl-Job
    xy_m0154_crawl_pages            Crawl-Ergebnisse je Seite
    xy_m0154_crawl_page_html        gespeichertes Frontend-HTML
    xy_m0154_crawl_findings         Befunde eines Crawl-Laufs
    xy_m0154_search_console_imports Importstände der GSC-CSV-Dateien
    xy_m0154_search_console_rows    importierte GSC-Zeilen (Queries/Seiten)
    xy_m0154_issue_state            Status/Notiz je Trefferzeile
    xy_m0154_not_found_log          protokollierte 404-Aufrufe
    xy_m0154_ai_settings            KI-Einstellungen
    xy_m0154_ai_suggestions         gespeicherte KI-Vorschläge
    xy_m0154_product_ai_refs        Referenz-URLs je Produkt (analog: category/content/
    xy_m0154_category_ai_refs       product_content)
    xy_m0154_content_ai_refs
    xy_m0154_product_content_ai_refs
    xy_m0154_activity_log           Nutzungs-/Aktivitätsprotokoll

    Ohne eigene Tabelle: public/sitemap*.xml, robots.txt, export/robots.txt.tpl und llms.txt
    werden direkt im Shop-Verzeichnis gelesen/geschrieben. Konfigurationswerte liegen in der
    Xycons-Tabelle xycons_configuration (Schlüssel mit Präfix XYCONS_MOD0154_).

9.2 TEXTE UND SPRACHEN

    Alle sichtbaren Texte stammen aus den Textphrasen-Dateien
    (Admin/TextPhrases/german/ - führend - und english/). Die JS-Oberfläche erhält ihre
    Texte über getJsI18nTexts() als window.xyM0154I18n. Jeder deutschen Phrase steht eine
    englische Übersetzung gegenüber.

9.3 RECHTE UND SICHERHEIT

    - Beim INIT legt das Modul die AdminAccess-Rechte für M0154Tools und M0154GeoTools an;
      sie sind über die Admin-Zugriffsverwaltung zuteilbar.
    - Jede schreibende Aktion prüft Adminrolle, Schreibrecht und CSRF-Token (nur POST).
    - Die Frontend-Toolbar zeigt Daten ausschließlich in einer Admin-Session.
    - Dateizugriffe der Bild-/Asset-Funktionen sind auf das Shopverzeichnis eingegrenzt
      (Traversal- und realpath-Prüfung).

9.4 HINWEISE FÜR TEST UND BETRIEB

    - Audit-Treffer sind sprach- und statusabhängig; die Auswahl oben steuert alle Kacheln.
    - Search-Console-Daten regelmäßig aktualisieren.
    - KI-Ausgaben redaktionell prüfen; übernommen wird nur, was gespeichert wird.
    - Redirect-Vorschläge sind fachliche Vorschläge, keine automatische Live-Übernahme.
    - Diese Handbuch- und Doku-Dateien sind lokal und nicht Teil des ausgelieferten Bundles.