dfsearchconsole — Google Search Console für PrestaShop

Überblick

dfsearchconsole synchronisiert die Daten von Google Search Console direkt in das Backoffice von PrestaShop 8 und 9: Top-Suchanfragen pro URL, CTR pro Seite, durchschnittliche Position und vor allem vier automatisch berechnete SEO-Chancen-Kategorien mit kontextuellen Optimierungsvorschlägen.

Das Modul fügt 5 Tabs unter Verbessern → Search Console hinzu: Dashboard, Seiten, Suchanfragen, Chancen und Einstellungen. Die Kommunikation mit Google erfolgt über OAuth2 im Nur-Lesen-Modus (Scope webmasters.readonly), ohne Composer-Abhängigkeit — ausschließlich natives cURL.

Installation

1. Laden Sie die ZIP-Datei des Moduls aus Ihrem DataFirefly-Kundenkonto herunter.
2. Im PrestaShop-Backoffice: Module → Modul-Manager → Modul hochladen.
3. Wählen Sie die ZIP-Datei aus und lassen Sie die Installation abschließen.
4. Das Modul erstellt 4 SQL-Tabellen (ps_dfgsc_sync, ps_dfgsc_page, ps_dfgsc_query, ps_dfgsc_opportunity) und registriert seine 5 Tabs unter dem Menü Verbessern.

OAuth-Konfiguration in Google Cloud

Das Modul kommuniziert mit der Search Console API über Ihre eigenen OAuth2-Anmeldedaten. Die Erstellung ist kostenlos und dauert etwa zehn Minuten.

1. Projekt anlegen und API aktivieren

1. Gehen Sie zu console.cloud.google.com und legen Sie ein Projekt an (oder verwenden Sie ein bestehendes).
2. Suchen Sie unter APIs und Dienste → Bibliothek nach Google Search Console API und aktivieren Sie sie.

2. Zustimmungsbildschirm konfigurieren

1. Öffnen Sie APIs und Dienste → OAuth-Zustimmungsbildschirm.
2. Nutzertyp: Extern (oder Intern, wenn Sie Google Workspace nutzen).
3. Tragen Sie den Anwendungsnamen, die Support-E-Mail und Ihre Domain ein.
4. Fügen Sie den Scope https://www.googleapis.com/auth/webmasters.readonly hinzu.
5. Solange die App nicht veröffentlicht ist, fügen Sie Ihre Google-Adresse als Testnutzer hinzu.

3. OAuth-Client-ID erstellen

1. Klicken Sie unter APIs und Dienste → Anmeldedaten auf Anmeldedaten erstellen → OAuth-Client-ID.
2. Anwendungstyp: Webanwendung.
3. Fügen Sie unter Autorisierte Weiterleitungs-URIs die im Einstellungen-Bildschirm des Moduls angezeigte URL ein (in der Form https://ihre-domain.com/module/dfsearchconsole/oauth).
4. Notieren Sie die Client-ID und das Client-Secret.

4. Modul verbinden

1. Öffnen Sie in PrestaShop Verbessern → Search Console → Einstellungen.
2. Fügen Sie Client-ID und Client-Secret ein und speichern Sie.
3. Klicken Sie auf Mit Google verbinden und erteilen Sie den Zugriff.
4. Zurück im Backoffice wählen Sie die zu synchronisierende Search Console-Property im Dropdown aus.

Synchronisation

Manuelle Synchronisation

Der Button Jetzt synchronisieren auf dem Einstellungen-Bildschirm startet sofort eine vollständige Synchronisation. Rechnen Sie mit wenigen Sekunden für einen kleinen Shop bis zu 2-3 Minuten für eine Seite mit Tausenden indexierter Seiten.

Automatische Synchronisation (Cron)

Der Einstellungen-Bildschirm zeigt eine Cron-URL, die durch ein zufälliges 32-Zeichen-Token geschützt ist. Fügen Sie sie zu Ihrer crontab für eine tägliche Synchronisation hinzu:

0 4 * * * curl -s "https://ihre-domain.com/module/dfsearchconsole/cron?token=IHR_TOKEN" > /dev/null

Lookback-Fenster

Standardmäßig ruft das Modul 90 Tage Daten plus die vorherigen 90 Tage ab, um die Deltas zu berechnen. Dieses Fenster ist in den Einstellungen von 28 bis 480 Tagen konfigurierbar. Je größer das Fenster, desto länger die Synchronisation.

Dashboard

Das Dashboard bietet einen Überblick: 4 KPI-Karten (Klicks, Impressionen, CTR, durchschnittliche Position) mit den Veränderungen zur Vorperiode, die Top 10 Seiten, die Top 15 Suchanfragen und eine Vorschau der prioritären Chancen.

Seiten und Suchanfragen

Tab Seiten

Paginierte, sortierbare Liste aller von Search Console gemeldeten URLs, mit Klicks, Impressionen, CTR, Position und Klick-Delta. Ein Filter grenzt nach Seitentyp (Produkt, Kategorie, CMS, Sonstige) oder Text ein. Ein Klick auf eine URL öffnet ihre Detailansicht: Seiten-KPIs mit Werten der Vorperiode, auf diese URL zielende Suchanfragen, zugehörige Chancen und ein direkter Link zur Bearbeitung der entsprechenden PrestaShop-Entität.

Tab Suchanfragen

Zwei Anzeigemodi:

• Gruppierte Ansicht — eine Zeile pro Suchanfrage, aggregiert über alle URLs. Ideal zur Identifikation Ihrer Hauptbegriffe.
• Detailansicht — eine Zeile pro Paar Suchanfrage × URL. Unverzichtbar für die Kannibalisierungsanalyse.

Die Positionen sind farbcodiert: grün (1-3), blau (4-10), gelb (11-20, boostbar), grau (21+).

SEO-Chancen

Nach jeder Synchronisation berechnet das Modul automatisch vier Chancen-Kategorien neu:

• Top 11–20 boostbar (Striking Distance) — Suchanfragen mit Position zwischen 11 und 20 (konfigurierbare Schwellenwerte) und einer Mindestanzahl Impressionen. Das Modul berechnet den potenziellen Klickgewinn durch Simulation eines Wechsels auf Position 5.
• CTR unter dem Durchschnitt (Top 10) — Top-10-Seiten, deren tatsächlicher CTR unter 50 % des erwarteten CTR gemäß der integrierten Referenzkurve liegt (aggregiert aus Studien von Advanced Web Ranking, Sistrix und Backlinko).
• Kannibalisierung — dieselbe Suchanfrage bringt 2 oder mehr URLs hervor. Das Modul listet die konkurrierenden URLs auf.
• Klickrückgang — Seiten, die mehr als 25 % Klicks gegenüber der Vorperiode verloren haben.

Jede Chance zeigt einen Prioritäts-Score, die zugehörigen Metriken und Optimierungsvorschläge, die an den Seitentyp angepasst sind (Produktseite, Kategorie oder CMS-Seite). Der Workflow Offen / Erledigt / Verworfen ermöglicht die Fortschrittsverfolgung. Der Button Neu berechnen baut alle Chancen aus den bereits vorhandenen Daten neu auf, ohne die Google-API erneut aufzurufen.

Schwellenwert-Einstellungen

In den Einstellungen steuern drei Schwellenwerte die Erkennung:

• Mindest-Impressionen (Standard 50) — darunter wird das Paar Suchanfrage × URL von den Detektoren ignoriert.
• Striking Distance Min-/Max-Position (Standard 11 / 20) — das als boostbar betrachtete Positionsfenster.

Für einen kleinen Shop mit wenig Traffic senken Sie den Impressionen-Schwellenwert auf 20-30. Für eine große Seite erhöhen Sie ihn auf 100+, damit nur signifikante Arbeiten angezeigt werden.

Fehlerbehebung

„Token abgelaufen“ oder Fehler 401

Das Refresh-Token wird automatisch jede Stunde verwendet. Wenn Google den Zugriff widerrufen hat (Passwortänderung, lange Inaktivität, manueller Widerruf), verbinden Sie das Modul erneut über den Button Mit Google verbinden auf dem Einstellungen-Bildschirm.

Keine Seite im Dropdown

Das verbundene Google-Konto muss Zugriff auf mindestens eine Search Console-Property haben (Inhaber oder Nutzer). Prüfen Sie dies unter search.google.com/search-console mit demselben Konto.

Fehler „redirect_uri_mismatch“ bei der Verbindung

Die in Google Cloud Console deklarierte Weiterleitungs-URI muss exakt der auf dem Einstellungen-Bildschirm des Moduls angezeigten entsprechen (inklusive https-Protokoll, ohne überflüssigen abschließenden Schrägstrich).

Sehr lange Synchronisation oder Timeout

Die API paginiert in Blöcken von 25.000 Zeilen. Für große Seiten: Erhöhen Sie memory_limit auf 512M, erhöhen Sie max_execution_time und bevorzugen Sie den Cron (der kein Browser-Zeitlimit hat).

URLs nicht zu PrestaShop-Entitäten aufgelöst

Der Resolver arbeitet mit dem link_rewrite (SEO-freundlicher URL-Slug). URLs, die von Drittanbieter-Routing-Modulen erzeugt werden, können unverknüpft bleiben: Sie erscheinen mit dem Typ „other“, werden aber weiterhin vollständig analysiert.

Deinstallation

Die Deinstallation entfernt die 4 SQL-Tabellen, die Admin-Tabs und alle Konfigurationsschlüssel (einschließlich der OAuth-Tokens). Denken Sie daran, den Zugriff der App in den Sicherheitseinstellungen Ihres Google-Kontos zu widerrufen, wenn Sie das Modul nicht mehr nutzen.