PS PrestaShop Mittel

GSC Connect — Dokumentation

Search Console Connect 2.0.0 installieren und nutzen: Google-Verbindungsassistent, Leistung pro Produkt und Kategorie, URL-Prüfung in Massen, Sitemaps, Benachrichtigungen, Cron und Sicherheit.

Aktualisiert Modulversion 2.0.0

Search Console Connect zeigt Ihre Google-Search-Console-Daten im PrestaShop-Backoffice an: Klicks, Impressionen, CTR und Position nach Produkt, Kategorie, CMS-Seite und Suchanfrage, URL-Prüfung in großen Mengen mit Warteschlange, Sitemaps und E-Mail-Benachrichtigungen. Dieser Leitfaden behandelt die Installation, den Google-Verbindungsassistenten, das Lesen der Berichte, die Prüfung, die Benachrichtigungen, den Cron, die Sicherheit und die Fehlerbehebung. Dokumentierte Version: 2.0.0, kompatibel mit PrestaShop 1.7.8 bis 9.

Unabhängigkeit von Google. Dieses Modul steht in keiner Verbindung zu Google und wird von Google weder unterstützt noch gesponsert. Es zeigt die Daten an, die die offizielle Search Console API mit Ihrem eigenen OAuth-Client liefert: Ihre Daten laufen nicht über DataFirefly. Es garantiert keine Verbesserung von Ranking, Traffic oder Indexierung.

Search-Console-Übersicht in PrestaShop: Klicks, Impressionen, CTR, durchschnittliche Position und Trenddiagramm
Search-Console-Übersicht in PrestaShop: Klicks, Impressionen, CTR, durchschnittliche Position und Trenddiagramm

Installation

  1. Backoffice → Module → Modulverwaltung → Modul hochladen, dann dfgscconnect-2.0.0.zip ablegen.
  2. Es erscheint ein Menü Search Console mit sechs Seiten: Übersicht, Performance, Indexierung, Sitemaps, Benachrichtigungen, Verbindung & Einstellungen.
  3. Öffnen Sie Verbindung & Einstellungen: Ein Assistent führt Sie in 4 Schritten durch die Einrichtung (beim ersten Mal etwa 10 Minuten).

Voraussetzungen

  • PrestaShop 1.7.8, 8.x oder 9.x; PHP 7.1 bis 8.5 (getestet mit 7.4, 8.1 und 8.5); Erweiterungen curl und openssl.
  • Ein Google-Konto, das Inhaber oder Nutzer der Search Console-Property des Shops ist.
  • Eine geplante Aufgabe (Cron) bei Ihrem Hoster für die Automatisierung.

Update von 1.0.x

Installieren Sie das neue Zip über das alte. Das Update-Skript behält die Google-Verbindung (die Tokens werden dabei verschlüsselt), die Property, die Metriken (Duplikate zusammengeführt), die Prüfungen, die Warteschlange und die Benachrichtigungen bei. Alte Benachrichtigungen werden nicht erneut per E-Mail gesendet.

Google-Verbindungsassistent

Schritt-für-Schritt-Verbindungsassistent: OAuth-Client in Google Cloud und Weiterleitungs-URI zum Kopieren
Schritt-für-Schritt-Verbindungsassistent: OAuth-Client in Google Cloud und Weiterleitungs-URI zum Kopieren

Schritt 1: Google-Cloud-OAuth-Client erstellen

  1. Erstellen Sie in der console.cloud.google.com ein Projekt und aktivieren Sie dann unter APIs und Dienste > Bibliothek die Google Search Console API.
  2. Konfigurieren Sie den Zustimmungsbildschirm (Typ Extern) mit dem Namen des Shops und Ihrer E-Mail-Adresse. Fügen Sie unter „Datenzugriff“ den Scope https://www.googleapis.com/auth/webmasters.readonly hinzu (oder webmasters, wenn Sie Sitemaps vom Shop aus verwalten möchten).
  3. Erstellen Sie eine OAuth-Client-ID vom Typ Webanwendung und fügen Sie die vom Modul angezeigte Adresse (Schaltfläche Kopieren) unter „Autorisierte Weiterleitungs-URIs“ ein. Bei Multishop hat jeder Shop seine eigene Adresse: Fügen Sie alle demselben Client hinzu.
  4. Veröffentlichen Sie die App (Status „In Produktion“). Im Status „Test“ macht Google die Autorisierung nach 7 Tagen ungültig, sodass Sie sich jede Woche neu verbinden müssten. Bei Ihrer eigenen Nutzung zeigt Google möglicherweise „Google hat diese App nicht überprüft“ an: Klicken Sie auf Erweitert und fahren Sie dann fort.
  5. Kopieren Sie die Client-ID und das Client-Secret in das Modul, wählen Sie den gewünschten Zugriff und speichern Sie. Das Secret wird verschlüsselt (AES-256) und nie wieder angezeigt.

Welchen Zugriff wählen? Nur Lesezugriff (empfohlen) genügt für Performance, URL-Prüfung und Sitemap-Status. Lesen + Sitemap-Verwaltung erlaubt zusätzlich, Sitemaps aus PrestaShop einzureichen und zu entfernen. Das Modul fragt außerdem openid email ab, um anzuzeigen, welches Google-Konto verbunden ist.

Schritt 2: Mit Google anmelden

Klicken Sie auf Mit Google anmelden und bestätigen Sie den Zustimmungsbildschirm: Sie gelangen verbunden zurück ins Backoffice. Das Konto, der gewährte Zugriff und der Verbindungsstatus werden angezeigt; Erneut verbinden und Trennen und widerrufen stehen zur Verfügung.

Aktive Google-Verbindung und Auswahl der Search-Console-Property (Domain oder URL-Präfix)
Aktive Google-Verbindung und Auswahl der Search-Console-Property (Domain oder URL-Präfix)

Schritt 3: Property auswählen

Das Modul listet die zugänglichen Properties auf und hebt diejenige hervor, die die Adresse des Shops abdeckt (eine Domain-Property sc-domain: deckt alle Subdomains ab; eine URL-Präfix-Property deckt eine bestimmte Adresse ab). Erweiterte Option: öffentliche Adresse, falls der Shop unter einer anderen Adresse ausgeliefert wird als der in PrestaShop festgelegten (Proxy, CDN).

Schritt 4: Automatisieren

Kopieren Sie die Cron-URL (vertraulich behandeln) und planen Sie sie alle 15 Minuten ein, zum Beispiel: */15 * * * * curl -fsS "URL" >/dev/null. Die Schaltfläche Jetzt ausführen startet sofort einen Durchlauf. Der Aktivitätsverlauf listet die letzten Aufgaben und etwaige Fehler auf, in verständlicher Sprache erklärt.

Verbindungstest mit einem Klick: OAuth-Client, Autorisierung, Property, Leistungsdaten
Verbindungstest mit einem Klick: OAuth-Client, Autorisierung, Property, Leistungsdaten

Die Schaltfläche Verbindung testen prüft Schritt für Schritt: OAuth-Client, Google-Autorisierung, Zugriff auf die Property, Lesen der Performance-Daten, Berechtigung zur Sitemap-Verwaltung.

Übersicht

Klicks, Impressionen, CTR und durchschnittliche Position der Property über 7 Tage bis 16 Monate, verglichen mit dem vorherigen Zeitraum oder dem Vorjahr. Die Summen stammen aus der Dimension „Datum“ der API: Es sind dieselben Zahlen wie in den Diagrammen der Search Console. Die Kurve zeigt Klicks, Impressionen, CTR, Position und den Vergleichszeitraum.

Top-Produkte, -Kategorien und -Suchanfragen, Seiten mit Klickverlusten und Chancen
Top-Produkte, -Kategorien und -Suchanfragen, Seiten mit Klickverlusten und Chancen

Weiter unten: Top-Produkte, Top-Kategorien, Top-Suchanfragen, Seiten mit Klickverlust, Chancen (Suchanfragen auf Position 4 bis 20 mit vielen Impressionen), Indexierungsstatus, Sitemaps und offene Benachrichtigungen. Google veröffentlicht seine Daten mit etwa 2 Tagen Verzögerung; der letzte Tag kann unvollständig sein.

Performance nach Produkt, Kategorie und Suchanfrage

Leistungsbericht pro Produkt: Klicks, Veränderung, Impressionen, CTR und Position
Leistungsbericht pro Produkt: Klicks, Veränderung, Impressionen, CTR und Position

Tabs Produkte, Kategorien, Suchanfragen, Alle Seiten und CMS-Seiten: Klicks, Entwicklung, Impressionen, CTR und Position (nach Impressionen gewichteter Durchschnitt, wie in der Search Console), Suche, Sortierung, Seitennavigation und CSV-Export (UTF-8 mit BOM, Semikolon als Trennzeichen).

Jede Google-URL wird anhand der Shop-Routen ihrer PrestaShop-Seite zugeordnet, einschließlich der benutzerdefinierten Regeln unter „SEO & URLs“, des Sprachpräfixes und nicht umgeschriebener URLs. Parameter (?utm_…, Seitennavigation, Filter) werden ignoriert: Alle Varianten einer Seite werden unter ihr zusammengefasst.

Google-Suchanfragen, die zu einer Produktseite führen, mit Klicks, Impressionen und Position
Google-Suchanfragen, die zu einer Produktseite führen, mit Klicks, Impressionen und Position

Die Detailschaltfläche zeigt die Suchanfragen, die zu einem Produkt, einer Kategorie oder einer Seite führen (Momentaufnahme der letzten 28 Tage), oder die Seiten, die für eine Suchanfrage ranken.

Leistung pro Kategorie, mit den Klicks der Produkte jeder Kategorie
Leistung pro Kategorie, mit den Klicks der Produkte jeder Kategorie

Der Kategorienbericht zeigt auch die Klicks der Produkte, deren Standardkategorie die jeweilige Kategorie ist.

Indexierung: URL-Prüfung in großen Mengen

URL-Prüfung in Massen: Indexierungsstatus, Warteschlange und heutiges Google-Kontingent
URL-Prüfung in Massen: Indexierungsstatus, Warteschlange und heutiges Google-Kontingent

Stellen Sie die in Google gesehenen Seiten (28 Tage) in die Warteschlange (empfohlen: Das sind die exakten URLs, die Google kennt), außerdem alle aktiven Produkte, alle Kategorien, die CMS-Seiten, die seit ihrer letzten Prüfung geänderten Seiten oder eine eingefügte URL-Liste. URLs außerhalb der Property werden ignoriert. Die Warteschlange wird vom Cron verarbeitet; Warteschlange jetzt ausführen verarbeitet sie von der Seite aus mit einer Fortschrittsanzeige.

Google-Kontingente. Die Prüf-API ist auf 2.000 Aufrufe pro Tag und 600 pro Minute je Property begrenzt (Zurücksetzung um Mitternacht, pazifische Zeit). Das Modul zählt jeden Aufruf, beachtet Ihre Obergrenzen (weiter unten einstellbar), pausiert die Warteschlange bei einem 429-Fehler und setzt sie von selbst fort; ein Kontingentfehler verbraucht keinen Versuch.

Prüfergebnisse: indexierte und nicht indexierte Seiten, von Google gewählte kanonische URL
Prüfergebnisse: indexierte und nicht indexierte Seiten, von Google gewählte kanonische URL

Filterbare Ergebnisse: indexiert, nicht indexiert, Fehler sowie Seiten, bei denen Google eine andere kanonische URL gewählt hat als die angegebene.

Details einer URL-Prüfung: Abdeckung, Crawling, robots.txt und kanonische URLs
Details einer URL-Prüfung: Abdeckung, Crawling, robots.txt und kanonische URLs

Die Detailansicht zeigt das Urteil, den Abdeckungsstatus, ob die Indexierung zulässig ist, den Abruf der Seite, die robots.txt, den letzten Crawl, den Crawler, die von der Seite angegebene und die von Google gewählte kanonische URL, die Sitemaps, die verweisenden Seiten und die erkannten Rich-Suchergebnisse. Die Prüfung zeigt die Version, die Google kennt (letzter Crawl), keinen Live-Test. „Nicht indexiert“ ist nicht immer ein Problem: Seiten mit einem Canonical-Tag auf eine andere URL, weitergeleitete Seiten oder Seiten mit noindex sind absichtlich ausgeschlossen.

Sitemaps

In der Search Console bekannte Sitemaps, Fehler und im Shop gefundene Sitemaps
In der Search Console bekannte Sitemaps, Fehler und im Shop gefundene Sitemaps

Liste der Search Console bekannten Sitemaps mit ihrem Status (Erfolg, ausstehend, Fehler, Warnungen), den eingereichten URLs je Typ, dem Einreichungsdatum und dem letzten Lesevorgang durch Google. Das Modul erkennt die Sitemaps des Shops (Zeilen Sitemap: der robots.txt, Google-Sitemap-Modul, DataFirefly Sitemap) und erlaubt es mit dem Zugriff „Sitemap-Verwaltung“, sie einzureichen, erneut einzureichen oder zu entfernen. Nur URLs, die von der Property abgedeckt sind, können eingereicht werden; das Entfernen einer Sitemap löscht die Datei nicht. Seit 2023 teilt Google die Anzahl der indexierten URLs pro Sitemap nicht mehr mit.

Benachrichtigungen

Benachrichtigungen: Positions- oder Klickverlust, deindexierte Seite, Sitemap-Fehler
Benachrichtigungen: Positions- oder Klickverlust, deindexierte Seite, Sitemap-Fehler
  • Positionsverlust und Klickrückgang: letzte 7 konsolidierte Tage im Vergleich zu den 7 Tagen davor, je Seite und für die gesamte Property, mit einstellbaren Schwellenwerten und Mindestwerten für Impressionen oder Klicks.
  • Seite nicht indexiert: eine indexierte Seite, die aus dem Index fällt, oder eine Seite, die Klicks bringt und nicht indexiert ist (außer bei absichtlichen Ausschlüssen).
  • Sitemap-Fehler, Google-Verbindung unterbrochen, Kontingent für URL-Prüfungen erreicht.

Benachrichtigungen werden dedupliziert, erledigen sich von selbst, wenn das Problem verschwindet, und können gesammelt als gelesen oder erledigt markiert werden.

Einstellungen: konfigurierbare Benachrichtigungen, Prüfkontingente, Verlauf und Cron-Aufgabe
Einstellungen: konfigurierbare Benachrichtigungen, Prüfkontingente, Verlauf und Cron-Aufgabe

Die E-Mail-Zusammenfassung (täglich, wöchentlich oder bei jedem Cron-Lauf) geht an bis zu 10 Empfänger, in der gewählten Sprache. Über eine Schaltfläche können Sie eine Test-E-Mail senden.

Zusammenfassende E-Mail der Search-Console-Benachrichtigungen, vom Shop gesendet
Zusammenfassende E-Mail der Search-Console-Benachrichtigungen, vom Shop gesendet

Einstellungen

Einstellung Standard Zweck
Zu importierender Verlauf 16 Monate Beim ersten Durchlauf geladene Tiefe, ein Monat pro Cron-Lauf (Search Console speichert 16 Monate).
Daten im Shop aufbewahren für 24 Monate Lokale Aufbewahrung (16, 24, 36 Monate oder unbegrenzt); über 16 Monate hinaus sind Vergleiche möglich, die Search Console nicht mehr bietet.
Prüfungen pro Tag / pro Minute 1.800 / 300 Obergrenzen des Moduls, unterhalb der Google-Limits (2.000 / 600).
Zu prüfende Sprachen Nur Standardsprache Oder alle aktiven Sprachen oder eine Auswahl.
Seiten automatisch erneut prüfen Aktiviert Nach der Änderung eines Produkts, einer Kategorie oder einer CMS-Seite. Das Speichern wird nicht verlangsamt: Die Änderung wird vermerkt und vom nächsten Cron-Lauf verarbeitet.
Daten bei Deinstallation behalten Deaktiviert Deaktiviert: Die Deinstallation widerruft die Google-Verbindungen und löscht die Tabellen des Moduls.

Sicherheit und Berechtigungen

  • OAuth 2.0 mit PKCE und einem zufälligen state-Parameter, nur einmal verwendbar, 15 Minuten gültig und an den Mitarbeiter und seinen Browser gebunden; der Code wird innerhalb der Sitzung des Mitarbeiters ausgetauscht.
  • Client-Secret, Zugriffstoken und Aktualisierungstoken verschlüsselt in der Datenbank; sie werden nie angezeigt oder in Protokolle geschrieben.
  • Trennen widerruft die Autorisierung bei Google. Lehnt Google die gespeicherte Autorisierung ab (Zugriff widerrufen, Passwort geändert, App im Status „Test“), wechselt der Shop auf „Neuverbindung erforderlich“, es wird eine Benachrichtigung erstellt und es erfolgen keine weiteren Aufrufe.
  • Berechtigungen pro Tab: Ein Profil mit ausschließlich der Berechtigung „Anzeigen“ kann alles einsehen, aber nichts ändern. CSRF-Token bei allen Aktionen.
  • Multishop: Jeder Shop hat seine eigene Verbindung, Property, Daten, Einstellungen und Benachrichtigungen.
  • Cron: Token-Vergleich in konstanter Zeit, Sperre gegen gleichzeitige Ausführungen, Antwort ohne interne Details. Der Google-Rückkehr-Controller und der Cron bleiben im Wartungsmodus erreichbar.

Fehlerbehebung

redirect_uri_mismatch auf dem Google-Bildschirm

Die in Google Cloud registrierte Weiterleitungsadresse stimmt nicht exakt mit der des Moduls überein (http/https, www, Pfad). Kopieren Sie sie erneut mit der Schaltfläche Kopieren.

Die Verbindung bricht nach 7 Tagen ab

Die OAuth-App steht bei Google noch im Status „Test“: Veröffentlichen Sie sie („In Produktion“) und verbinden Sie den Shop anschließend erneut.

„Die Google Search Console API ist nicht aktiviert“

Aktivieren Sie die API in der Bibliothek des Google-Cloud-Projekts, warten Sie einige Minuten und testen Sie dann die Verbindung.

Keine Produkte in den Berichten

Prüfen Sie, ob die Property die Adresse des Shops abdeckt. Wird der Shop hinter einem Proxy oder CDN ausgeliefert, tragen Sie die öffentliche Adresse ein (Schritt 3).

Die Prüfwarteschlange ist pausiert

Das Tageskontingent ist erreicht (Ihr eigenes oder das von Google) oder Google hat zum Drosseln aufgefordert: Die Warteschlange wird von selbst fortgesetzt. Die Schaltfläche Jetzt fortsetzen hebt die Pause auf.

Die Benachrichtigungs-E-Mails kommen nicht an

Prüfen Sie die Empfänger und die E-Mail-Konfiguration von PrestaShop (Erweiterte Parameter > E-Mail) und verwenden Sie dann Test-E-Mail senden. Schlägt der Versand fehl, versucht das Modul es höchstens alle 6 Stunden erneut.

Daten und Deinstallation

Tabellen ps_dfgsc_* (Verbindung, Properties, Tagessummen, Seiten, Suchanfragen, Seite-Suchanfrage-Paare, URL-Zuordnung, Prüfungen, Warteschlange, Kontingente, Sitemaps, Benachrichtigungen, Aufgabenverlauf) und Schlüssel DFGSC_*. Die Deinstallation widerruft die Google-Verbindungen und löscht diese Daten, es sei denn, „Daten bei Deinstallation behalten“ ist aktiviert. Chart.js 4.4.0 (MIT-Lizenz) ist enthalten und wird nur auf den Modulseiten geladen, die Diagramme anzeigen.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren