Google Customer Reviews: Einrichtung und Hilfe

1. Laden Sie das mprgooglereviews-ZIP unter Module > "Module Manager" hoch und installieren Sie es.
2. Klicken Sie auf "Configure" oder öffnen Sie "Google Reviews" > Einstellungen > "Configuration".
3. Wählen Sie bei Multistore den gewünschten Shop-Kontext.
4. Geben Sie Ihre numerische "Händler-ID" aus Google Merchant Center ein.
5. Legen Sie "Geschätzte Liefertage", "Badge-Position" und "Badge-Sprache" fest.
6. Aktivieren Sie "Google Customer Reviews aktivieren" und speichern Sie.
7. Testen Sie in einer neuen Browser-Kundensitzung mit Marketing-Einwilligung. Schließen Sie eine Testbestellung ab und prüfen Sie deren native Bestellbestätigungsseite.

Ihr Google-Konto muss für das Customer Reviews-Programm eingerichtet sein. Das Modul ist anfangs deaktiviert und die Merchant ID leer. Es erstellt und verwaltet Ihr Google-Konto nicht.

Einstellungen werden von allen Shops an die Shop-Gruppe und dann an den Shop vererbt. Speichern Sie im richtigen Kontext. Geerbte Einstellungen verwenden entfernt lokale Überschreibungen, soweit verfügbar. Zum Anzeigen der Einstellungen ist eine Backoffice-Leseberechtigung erforderlich; zum Speichern zusätzlich die passende Bearbeitungsberechtigung und eine gültige Anfrage.

Das Modul lädt seine Browserskripte über displayHeader und stellt die Daten der Bestellumfrage über displayOrderConfirmation bereit. Es zeigt das Badge über displayBeforeBodyClosingTag an, mit displayFooter als Fallback bei PrestaShop-Versionen unter 1.7.

Das Google-Skript wird nur geladen, wenn Marketingeinwilligung, Regeln für internen Traffic, Richtlinien zur Datenübermittlung und Modulzuständigkeit dies erlauben. Testen Sie als Kunde statt als markierter Backoffice-Mitarbeiter. Ist ein anderes unterstütztes Modul für Google Customer Reviews mit derselben Merchant ID zuständig, zeigt dieses Modul einen Zuständigkeitshinweis und überlässt ihm Badge und Umfrage. Sein "Product Review Feed" bleibt davon unabhängig.

Auf der standardmäßigen Bestellbestätigungsseite des Shops enthalten die Umfragedaten:

• Merchant ID und Bestell-ID.
• Kunden-E-Mail und ISO-Code des Lieferlandes.
• Aus "Geschätzte Liefertage" berechnetes geschätztes Lieferdatum.
• Eindeutige numerische GTIN-Werte mit 8, 12, 13 oder 14 Ziffern aus den mit den gekauften Artikeln gespeicherten EAN-13-Feldern, sofern vorhanden. Eine GTIN-Prüfsumme wird nicht geprüft.

Die Bestätigungsantwort wird als privat und nicht cachebar gekennzeichnet. Ein Zustellprotokoll verhindert die wiederholte Freigabe für denselben Shop, dasselbe Google-Ziel und dieselbe Bestellung. Das Neuladen einer alten Bestätigung ist kein zuverlässiger Weg, einen Test zu wiederholen. Verwenden Sie eine neue Testbestellung.

Google steuert die Opt-in-Oberfläche, nachfolgende Bewertungseinladungen, die Verfügbarkeit des Badges und die Berechtigung für Bewertungen. Es gibt keinen separaten Schalter, um das Badge auszublenden und die Umfrage aktiviert zu lassen.

Öffnen Sie "Google Reviews" > "Product Review Feed". Diese Seite erzeugt öffentliche Google Product Reviews-XML-Dateien nach Schema 2.4 aus Ihren vorhandenen Produktbewertungen. Sie ist von der Erfassung von Verkäuferbewertungen nach dem Kauf unabhängig.

Speichern Sie Ihre Einstellungen und klicken Sie dann auf "Jetzt generieren". Der Statusbereich listet öffentliche XML-URLs, geschriebene und übersprungene Bewertungen auf. Dateien verwenden dieses Muster:

https://example.com/modules/mprgooglereviews/feeds/reviews_1_en.xml

Sie erhalten eine Datei je freigeschaltetem aktivem Shop und aktiver Sprache. Die Produktzuordnung umfasst verfügbare Namen, URLs, GTIN, Marke und SKU. MPN ist verfügbar, soweit das PrestaShop-Produktschema es unterstützt. Übermitteln Sie Google die öffentlichen XML-URLs, nicht den Generierungsendpunkt.

Eine "Generische Tabelle" zuordnen

Verwenden Sie eine eigene öffentliche Bewertungstabelle. Tabellen- und Spaltenbezeichner dürfen nur Buchstaben, Ziffern und Unterstriche enthalten. In "Generische Tabelle" können Sie das Datenbankpräfix des Shops angeben oder weglassen.

Ordnen Sie bei einer Tabelle mit id_review, id_product, rating, customer_name, title, comment, date_add und active diese Felder zu. Behalten Sie für eine Fünf-Sterne-Quelle die Skalenwerte 1 und 5 bei. Diese Version hält generische Zuordnungen nicht bis zur Freigabe öffentlicher Spalten zurück und erkennt private Felder nicht anhand ihres Zwecks. Prüfen Sie jede zugeordnete Spalte vor der Veröffentlichung des XML.

Der Bereich "External cron URL" zeigt für jeden Shop eine eigene URL mit Token an, kein separates Feld "Cron token". Zum Anzeigen benötigen Sie Bearbeitungsberechtigung und eine verifizierte Backoffice-Browsersitzung. Behandeln Sie die vollständige URL wie ein Geheimnis.

Senden Sie eine HTTPS-POST-Anfrage. Die angezeigte URL enthält das Token im Query-String; diese Version akzeptiert es dort. Um es aus der Scheduler-URL herauszuhalten, entfernen Sie den Tokenparameter aus der URL und senden denselben Wert im POST-Body als token. Der Header X-MPR-Review-Feed-Token wird nicht unterstützt.

curl --request POST \
  --data-urlencode 'token=YOUR_SHOP_TOKEN' \
  'https://example.com/index.php?fc=module&module=mprgooglereviews&controller=reviewfeed&id_shop=1'

Der Endpunkt gibt JSON für diesen Shop zurück. GET liefert 405. Ein ungültiges Token oder ein unpassender Shop wird abgelehnt. Planen Sie eine separate Anfrage für jeden verwendeten Shop.

Der PHP-Prozess benötigt Schreibzugriff auf modules/mprgooglereviews/feeds/. Das Modul schreibt Zugriffsregeln, die XML erlauben und PHP-, temporäre und Sperrdateien auf Servern sperren, die diese Regeln beachten. Stellen Sie einen gleichwertigen Schutz sicher, wenn Ihr Server .htaccess ignoriert.

• Badge oder Umfrage fehlt: Prüfen Sie Aktivierungszustand, Merchant ID, Marketing-Einwilligung, Mitarbeitermarkierungen und etwaige Zuständigkeitshinweise. Prüfen Sie Browserkonsole und Netzwerkfehler.
• Umfrage fehlt bei einer angepassten Kasse: Stellen Sie sicher, dass der native Bestellbestätigungs-Hook eine gültige Bestellung erhält. Cachen oder prerendern Sie die Bestätigungsantwort nicht.
• Ungültige Einstellungen: Verwenden Sie eine numerische Merchant ID, Liefertage von 0 bis 365, eine aufgeführte Position und einen gültigen Sprachcode.
• Leerer Feed: Prüfen Sie Quellenverfügbarkeit, Freigabestatus, Bewertungstext, Daten, Bewertungspunktzahlen, aktive Produkte und Produkt-URLs. Prüfen Sie die Anzahl übersprungener Bewertungen.
• Generischer Feed schlägt fehl: Prüfen Sie Tabelle, zugeordnete Spaltennamen, Pflichtfelder und eine stabile Bewertungs-ID oder einen Primärschlüssel. Diese Version hat keinen Ablauf zur Freigabe öffentlicher Spalten.
• Generierung schlägt fehl: Prüfen Sie Schreibzugriff auf das Verzeichnis, Shop-Berechtigungen des Mitarbeiters und ob bereits eine andere Generierung läuft.
• Cron schlägt fehl: Verwenden Sie POST, den korrekten Shop-Endpunkt und dessen token-Parameter im Query-String oder POST-Body. Eine reine Header-Authentifizierung wird nicht unterstützt.
• Konfiguration kann nicht gelesen werden: Öffnen Sie "Google Reviews" > Einstellungen > "Integrity".

Konfigurieren Sie Badge und Umfrage in den Moduleinstellungen. Überschreibungen von order-confirmation.tpl und badge.tpl steuern diese Einstellungen nicht.

Deaktivieren Sie "Google Customer Reviews aktivieren", um Badge- und Umfrageausgabe zu stoppen. Deaktivieren Sie "XML-Feed für Produktbewertungen aktivieren" separat, um die weitere Feed-Generierung zu stoppen. Vorhandene XML-Dateien bleiben öffentlich; entfernen Sie sie zum Zurückziehen eines Feeds aus dem Feed-Verzeichnis.

Deinstallieren Sie das Modul im "Module Manager", um Modulmenü und Konfiguration zu entfernen. Erzeugte XML-Feeds bleiben im Feed-Verzeichnis, wenn Sie die Moduldateien auf dem Datenträger behalten. Prüfen und entfernen Sie verbleibende öffentliche XML-Dateien. Bereits bei Google gespeicherte Bewertungen liegen außerhalb des lokalen Modulspeichers.

Erfordert PrestaShop 1.6 oder neuer und PHP 7.1 oder neuer.