Google Reviews einrichten
So verbindest du Google Reviews mit der Places API oder deinem Google Business Profile und zeigst Bewertungen per Portlet oder schwebendem Badge in deinem Shop an.
- 6 Min. Lesezeit
Öffne im Shop-Backend Plugins > Installierte Plugins > Themeart Google Reviews. Die Einrichtung erfolgt in den Bereichen Einstellungen, Google Verbindung und Dashboard. Änderungen unter Einstellungen übernimmst du mit Speichern.
1. Google-Verbindung wählen
Es stehen zwei Möglichkeiten zur Verfügung:
Verbindung | Voraussetzungen | Verfügbare Bewertungen |
|---|---|---|
Google Places API | Google API Key und Place ID | Bis zu fünf von Google ausgewählte Bewertungen |
Google Business Profile | OAuth-Verbindung mit Zugriff auf das Unternehmensprofil | Mehr als fünf Bewertungen, begrenzt durch das eingestellte Abruflimit |
Sobald ein Business-Profile-Konto mit Standort vollständig verbunden ist, verwendet das Plugin diese Verbindung. Andernfalls verwendet es die Places-Konfiguration.
Places API einrichten
- Öffne die Google Cloud Console und wähle dein Projekt.
- Aktiviere Places API (New) und richte die dafür erforderliche Abrechnung ein.
- Erstelle einen API-Schlüssel und beschränke ihn auf die benötigte API. Die Anfragen erfolgen vom Shop-Server, eine Beschränkung auf Website-Referrer ist dafür ungeeignet. Verwende stattdessen eine Server-IP-Beschränkung, sofern dein Hosting das ermöglicht.
- Ermittle die Place ID deines Unternehmens mit dem Place ID Finder von Google.
- Trage unter Einstellungen den Google API Key und die Google Place ID ein.
- Wähle die Sprache der Bewertungen und speichere. Die Places API berücksichtigt die Sprache, soweit Google entsprechende Inhalte bereitstellt.
- Öffne das Dashboard, um den Abruf zu kontrollieren.
Hinweis: Die Places API liefert höchstens fünf Bewertungen. Eine höhere Anzeigeanzahl oder eine andere Sortierung lädt keine weiteren Bewertungen nach. Bei jedem neuen Seitenaufruf können API-Anfragen entstehen – berücksichtige die Quoten und Kosten deines Google-Projekts.
Business Profile einrichten
Du benötigst ein Google-Konto mit Berechtigung für das gewünschte Unternehmensprofil und ein für die Business Profile APIs freigeschaltetes Google-Cloud-Projekt. Beachte dazu die Einrichtungsvorgaben von Google.
- Aktiviere die APIs Google My Business API, My Business Account Management API und My Business Business Information API. Fehlt der API-Zugriff, kläre zuerst die Projektfreigabe bei Google.
- Richte den OAuth-Zustimmungsbildschirm ein. Befindet sich die Anwendung im Testmodus, muss dein Google-Konto als Testnutzer zugelassen sein.
- Erstelle einen OAuth-2.0-Client vom Typ Webanwendung.
- Öffne im Plugin Google Verbindung und kopiere die angezeigte Redirect-URI unverändert in die autorisierten Weiterleitungs-URIs des OAuth-Clients. Protokoll, Domain, Pfad und gegebenenfalls Port müssen übereinstimmen.
- Trage unter Einstellungen die OAuth Client ID und das OAuth Client Secret ein und speichere.
- Starte unter Google Verbindung die Anmeldung bei Google und erteile den angezeigten Zugriff für die Verwaltung des Unternehmensprofils.
- Wähle das passende Konto und den gewünschten Standort aus und speichere die Auswahl.
- Kontrolliere den Verbindungsstatus und die Bewertungen im Dashboard.
Unter Max. Bewertungen abrufen (Business Profile API) legst du fest, wie viele Bewertungen geladen werden: 10, 25, 50, 100 oder 200. Wähle mindestens so viele, wie du anzeigen möchtest. Größere Abrufmengen können zusätzliche API-Anfragen erfordern.
Eine unterbrochene Einrichtung setzt du unter Google Verbindung fort. Zum Wechseln des Kontos oder bei entzogener Berechtigung verbindest du dort neu bzw. setzt die Verbindung zurück und richtest Konto und Standort erneut ein.
2. Bewertungen auf Content-Seiten platzieren
- Öffne die gewünschte Seite im OnPage Composer.
- Füge das Portlet Google Reviews aus der Gruppe Themeart ein.
- Platziere es bei Bedarf in einem eigenen Container-Portlet. Das Google-Reviews-Portlet fügt keinen eigenen
container-fluidhinzu. - Öffne die Einstellungen des Portlets und wähle den Anzeigestil:
- Karten: Bewertungen nebeneinander
- Liste: Bewertungen untereinander
- Slider: Bewertungen als Karussell
- Masonry Grid: Bewertungen in einem versetzten Spaltenraster
- Stelle Filter und Anzeigeoptionen ein, speichere den Entwurf und veröffentliche die Seite im OnPage Composer.
Den Anzeigestil wählst du ausschließlich im jeweiligen Portlet. Mehrere Portlets dürfen unterschiedliche Darstellungen verwenden. In der Vorschau erscheinen sie zum Beispiel als Google Reviews (Slider).
Einstellungen pro Portlet
Einstellung | Wirkung |
|---|---|
Sortierung | Google-Reihenfolge, neueste, beste oder schlechteste Bewertung zuerst. Sortiert die tatsächlich abgerufenen Bewertungen. |
Mindest-Sternzahl | Blendet Bewertungen unterhalb der gewählten Sternzahl aus. |
Anzahl anzeigen | Begrenzt die Anzahl sichtbarer Bewertungen. Mehr als fünf erfordern das Business Profile. |
Nur Bewertungen mit Text | Blendet reine Sternebewertungen ohne Text aus. |
Gesamtbewertung anzeigen | Zeigt Googles Gesamtbewertung und Gesamtanzahl oberhalb der Bewertungen. |
Autorenfotos anzeigen | Lädt verfügbare Profilbilder. Standardmäßig ausgeschaltet. |
Datum anzeigen | Zeigt den Zeitpunkt der Bewertung. |
„Auf Google ansehen“-Link | Zeigt einen verfügbaren Google-Link des Bewertenden. |
Text kürzen ab | Kürzt längere Texte mit „Mehr lesen“. „Nicht kürzen“ zeigt den vollständigen Text. |
Gesamtbewertung und Gesamtanzahl stammen aus Googles Gesamtstatistik. Sie müssen deshalb nicht mit der Anzahl oder dem Durchschnitt der gefilterten, sichtbaren Bewertungen übereinstimmen.
Hinweis: Der Slider nutzt die Slider-Integration des NOVA-Templates. Bei einem anderen Template muss dessen Anbieter eine entsprechende Integration bereitstellen. Alternativ wählst du Karten, Liste oder Masonry Grid.
3. Globale Vorgaben und automatische Einbindung
Die globalen Optionen unter Filter & Anzeige sowie Automatische Einbindung und Anzeigevorgaben gelten für die automatische Einbindung. Einstellungen im Portlet haben Vorrang.
Für die übliche Einbindung über den OnPage Composer lässt du CSS-Selektor (automatische Einbindung) leer.
Sollen die Bewertungen stattdessen automatisch an einem bestehenden Seitenelement erscheinen, trage dessen CSS-Selektor ein, z. B. #google-reviews, und wähle die Einbindungsmethode:
Methode | Position |
|---|---|
append | innerhalb des Zielelements, am Ende |
prepend | innerhalb des Zielelements, am Anfang |
after | direkt nach dem Zielelement |
before | direkt vor dem Zielelement |
Die automatische Einbindung verwendet das Kartenlayout. Für Liste, Slider oder Masonry Grid nutzt du das Portlet. Vermeide eine zusätzliche Einbindung per Selektor, wenn die Bewertungen bereits über ein Portlet an derselben Stelle erscheinen.
4. Schwebenden Bewertungs-Badge einrichten (optional)
Der Floating Review Badge ist unabhängig von den Portlets. Aktiviere ihn nur, wenn du zusätzlich eine feste Bewertungsanzeige am Bildschirmrand möchtest.
- Badge aktivieren: schaltet die Anzeige im Shop ein oder aus.
- Badge-Darstellung: horizontale Bewertungskarte, vertikale Bewertungskarte, Community-Karte oder kompakte Bewertungskapsel.
- Badge-Position: unten rechts oder unten links.
- Google Maps / Bewertungs-URL: der Maps- oder Bewertungslink deines Unternehmens für die Bewertungsaktion. Ohne Link erscheint keine externe Bewertungsaktion, die Community-Karte bietet dann „Bewertungen ansehen“ an.
- Reviews im Popup (Anzahl): null bis drei Vorschauen. Null zeigt nur die Zusammenfassung. Berücksichtigt werden Bewertungen mit mindestens vier Sternen und Text.
Ein Klick öffnet die Details, mit Escape schließt du das Popup. Für Profilbilder im Badge gilt die globale Einstellung Autorenfotos anzeigen.
5. Aktualisierung und Cache
Unter Cache-Dauer wählst du für Business-Profile-Daten 6, 12 oder 24 Stunden. In diesem Zeitraum werden bereits geladene Bewertungen angezeigt. Für einen neuen Abruf öffnest du Dashboard > Cache-Management > Cache jetzt leeren.
Places-Daten werden nicht dauerhaft im Shop gespeichert. Mehrere Einbindungen auf derselben Seite verwenden dieselbe Antwort.
Aktiviere Autorenfotos nur, wenn die Bilder direkt von den Browsern deiner Besucher geladen werden dürfen. Die Einstellung gibt es global und separat in jedem Portlet.
6. Häufige Probleme
Problem | Lösung |
|---|---|
Keine Bewertungen sichtbar | Verbindung im Dashboard prüfen. API Key und Place ID bzw. OAuth-Konto und Standort kontrollieren. Mindest-Sternzahl und Textfilter testweise lockern. |
Weniger Bewertungen als eingestellt | Places liefert höchstens fünf. Beim Business Profile das Abruflimit prüfen. Filter reduzieren die sichtbare Anzahl zusätzlich. |
Google lehnt die OAuth-Weiterleitung ab | Die Redirect-URI aus „Google Verbindung“ exakt im OAuth-Client hinterlegen. |
Konto oder Standort fehlt | Mit dem berechtigten Google-Konto anmelden, Projektfreigabe und aktivierte Business Profile APIs prüfen. |
Neue Bewertungen fehlen | Cache im Dashboard leeren und die Seite neu laden. Places zeigt nur Googles Auswahl. |
Bewertungen erscheinen doppelt | CSS-Selektor leeren oder ein doppelt platziertes Portlet entfernen. |
Falsches Layout auf einer Content-Seite | Das Portlet öffnen, den Anzeigestil wählen und die Seite im OnPage Composer veröffentlichen. |
Slider erscheint nicht als Karussell | Slider-Unterstützung des Templates prüfen oder einen anderen Anzeigestil wählen. |