Zum Hauptinhalt springen

Wie du Google-Bewertungen auf deiner Astro-Website integrierst

Google-Bewertungen auf deiner Astro-Website mit Hilfe deines KI-Programmieragenten einbinden.

A
Verfasst von Axel Lavergne

Um Google-Bewertungen optimal auf deiner Astro-Website anzuzeigen, solltest du sie während der Erstellung der Website über eine Bewertungs-API einbinden. Aktualisiere anschließend regelmäßig einen Zeitplan. So landen die Bewertungen in deinem statischen HTML, was die Seite schneller macht, für Suchmaschinen lesbar bleibt und deinen API-Schlüssel schützt. Der benötigte Code ist am Ende bereitgestellt, zusammen mit einer Anleitung für deinen KI-Programmieragenten. Überlege dir jedoch zuerst vier entscheidende Punkte, um die Integration optimal zu gestalten.

TLDR

  • Google-Bewertungen zeigst du auf einer Astro-Website am besten, indem du sie beim Build über eine Bewertungs-API abrufst, sodass die Bewertungen im statischen HTML landen und dein API-Schlüssel nie den Browser erreicht.

  • Die Reviewflowz API holt deine Google-Bewertungen ohne Zugriff auf das Google Business Profile und ohne Freigabe durch Google, und dieselbe API liefert Bewertungen von über 200 Plattformen in denselben Feldern.

  • Ein Reviewflowz-Bewertungs-Widget ist ein einzelner iframe, den du frei anpasst, sodass du immer aktuelle Google-Bewertungen auf einer Astro-Website zeigst, ohne sie neu zu bauen.

  • Mit den Tags von Reviewflowz fragt jede Seite deiner Website nur die Bewertungen ab, die zu ihr passen, egal ob du Bewertungen von Hand taggst oder die KI taggen lässt.

Wie du Bewertungen abrufst: beim Aufbau, beim Seitenausladen oder mit iframe

Du hast drei Möglichkeiten, die Bewertungen auf deiner Seite einzufügen. Jede Option beeinflusst Geschwindigkeit, Aktualität und Indizierbarkeit der Seite unterschiedlich.

Option

Funktionsweise

Der Kompromiss

Beim Aufbau

Astro zieht die Bewertungen während des Seitenaufbaus und speichert sie im HTML.

Die schnellste und effizienteste Methode. Die Bewertungen sind so aktuell wie dein letzter Aufbau. Wenn du selten aktualisierst, lege tägliche oder wöchentliche Cron-Jobs an.

Asynchron beim Laden der Seite

Ein Skript lädt die Bewertungen nach dem Öffnen der Seite.

Beeinflusst die Indizierung und Lesbarkeit der Seite negativ.

Iframe beim Laden der Seite

Die Seite integriert ein Bewertungs-Widget in einem Iframe.

Ein guter Kompromiss: Immer aktuell und gleichzeitig schnell geladen, da das Widget statisch ist.

Für Astro ist der Aufbau die beste Lösung. Der Code im Frontmatter einer Komponente läuft beim Seitenaufbau, sodass die Bewertungen als reines HTML vorhanden sind, wenn jemand die Seite öffnet, ohne dass der Schlüssel den Browser erreicht.

Der Iframe ohne Aufbau. Das Reviewflowz-Widget lädt sich als Iframe, den du individuell anpassen kannst. Er bleibt aktuell und lädt statisch, sodass die Ladezeit besonders kurz ist. Du findest es unter Integrationen im Widgets-Tab.

Woher die Bewertungen kommen: Places API, Business Profile API oder eine Drittanbieter-API

Die Wahl der Quelle bestimmt, wie viele Bewertungen du zeigen kannst und der Aufwand bis zur Anzeige der ersten Bewertung.

Quelle

Was du bekommst

Was es erfordert

Google Places API

5 zufällig ausgewählte Bewertungen, die älter und weniger relevant sein können.

Einen API-Schlüssel von Google Cloud.

Google Business Profile API

Alle Bewertungen deines Profils.

Zuerst eine Genehmigung: Du beantragst Zugang, Google prüft innerhalb von 14 Tagen. Dann OAuth mit Eigentümer- oder Managerzugriff auf das Profil.

Eine Drittanbieter-Bewertungs-API

Alle deine Bewertungen und auch von anderen Plattformen.

Einen API-Schlüssel. Kein Zugriff auf das Business Profile nötig.

Fünf Bewertungen bringen dich nicht weit. In der Praxis benötigst du also Zugang zum Business Profile, über die Genehmigung von Google oder einen Service, der dies für dich erledigt.

Kein Business Profile Zugang nötig. Die Reviewflowz-API holt deine Google-Bewertungen ohne Business Profile Zugang und ohne Google-Genehmigung. Sie deckt über 200 Plattformen ab, alles in denselben Feldern. Hier ist was es für Google zurückgibt.

Welche Bewertungen du anzeigen solltest

Alle Bewertungen anzuzeigen ist einfach, aber selten optimal. Bevor du anfängst zu programmieren, überlege:

  • Alle Bewertungen oder eine Auswahl?

  • Manuell ausgewählt oder automatisch?

  • Mit Kriterien: Mindestbewertung, Text muss vorhanden sein, die neuesten zuerst?

  • Nach Thema, Ort, Sprache oder dem Inhalt der Seite gefiltert?

Der unten stehende Code wählt automatisch nach bestimmten Regeln aus: 6 Bewertungen, 5 Sterne, mit Text, noch auf Google, die neuesten zuerst. Jede Regel ist kommentiert, sodass du sie leicht anpassen kannst. Drei weitere Filter sind möglich: language=en für bestimmte Sprachen, location=<id> für einen bestimmten Standort, und tag=<id> für manuell oder KI-getaggte Bewertungen. Mehr dazu im Artikel über Review-Tags.

Mit Tags bewerten, spezifisch pro Seite. In Reviewflowz kannst du Bewertungen manuell taggen oder von KI taggen lassen. Jede Seite bekommt eigene Tags. Lugg hat seine Bewertungsseite so angepasst: Besucher wählen einen Anwendungsfall und eine Stadt und sehen dazu passende Bewertungen. Etwa 6 bis 9 % der neuen Nutzer sehen zuerst eine Bewertungsseite. Der Testimonial-Leitfaden zeigt die Einrichtung.

Bewertungen von anderen Plattformen

Wenn du mehr als nur Google-Bewertungen nutzen möchtest, benötigst du auch hier eine Drittanbieter-Bewertungs-API. Plattformen wie Tripadvisor verbieten es, eigene Bewertungen auf der eigenen Website zu verwenden. Einige ignorieren dies. Bevorzugt wird jedoch ein Link zur Originalbewertung, um Einwände zu vermeiden.

Der folgende Code macht dies für Google-Bewertungen: Jede Bewertung enthält eine url, die zur Bewertung auf Google weiterleitet, und die Komponente zeigt dies als "Auf Google lesen" an, damit Besucher die Echtheit prüfen können.

Andere Plattformen, gleicher Ablauf. Mit Reviewflowz funktionieren Tripadvisor, Trustpilot und andere Plattformen über denselben Request: Passe nur platform an und die Bewertungen werden angezeigt, inklusive ihrer url. Der Testimonial-Leitfaden zeigt alle Filter.

So fügst du Google-Bewertungen zu deiner Astro-Website hinzu

Schritt 1. Öffne in Reviewflowz Bewertungsquellen und klicke auf Neue Bewertungsquelle. Wähle Google Maps aus, suche nach deinem Unternehmen und wähle es aus.

Die Seite Neue Bewertungsquelle mit Google Maps ausgewählt und einem Unternehmen, das nach Namen gefunden wurde

Schritt 2. Gehe zu Einstellungen → Webhooks & API und klicke auf Erstellen Sie einen API-Schlüssel. Benenne ihn, wähle Nur lesen und erstelle ihn. Diese Funktion ist im Premium-Paket enthalten.

Das Fenster API-Schlüssel erstellen mit der Berechtigung Nur lesen ausgewählt

Schritt 3. Füge den Schlüssel in die .env-Datei im Hauptverzeichnis deines Projekts als REVIEWFLOWZ_KEY hinzu. Setze dieselbe Variable bei den Umgebungsvariablen auf deinem Build-Server, damit sie beim Aufbau gelesen werden kann. Schritt 4. Erstelle src/components/GoogleReviews.astro und füge diesen Code ein:

---
// src/components/GoogleReviews.astro
// Dieser Code wird beim Seitenaufbau ausgeführt: Der Schlüssel bleibt auf deinem Rechner oder Build-Server,
// kommt nie auf die Seite. REVIEWFLOWZ_KEY=rfz_live_... in der .env-Datei setzen.
const params = new URLSearchParams({
platform: "google_maps", // Nur Google-Bewertungen
rating_min: "5", // 5 Sterne
has_text: "true", // mit geschriebenem Text
removed: "false", // Immer noch auf Google
sort: "date", // Neuste zuerst
limit: "6", // Anzahl der anzuzeigenden Bewertungen
});

const res = await fetch(`https://api.reviewflowz.com/v3/reviews?${params}`, {
headers: { Authorization: `Bearer ${import.meta.env.REVIEWFLOWZ_KEY}` },
});
if (!res.ok) throw new Error(`Reviewflowz API ${res.status}: ${await res.text()}`);
const { data: reviews } = await res.json();
---

<section class="google-reviews">
{reviews.map((review) => (
<figure>
<p aria-label={`${review.rating} von 5 Sternen`}>{"★".repeat(Math.round(review.rating))}</p>
<blockquote>{review.text}</blockquote>
<figcaption>
{review.reviewer.name}
{review.url && <a href={review.url} target="_blank" rel="noopener">Auf Google lesen</a>}
</figcaption>
</figure>
))}
</section>

Schritt 5. Integriere die Komponente auf jeder gewünschten Seite und platziere <GoogleReviews /> dort, wo die Bewertungen angezeigt werden sollen. Schritt 6. Halte alles aktuell: Erstelle die Seite regelmäßig täglich oder wöchentlich neu oder lasse sie neu erstellen, wenn ein Webhook eine neue Bewertung meldet.

Empfehlung für deinen KI-Programmieragenten: Füge deiner Astro-Seite einen Abschnitt für Google-Bewertungen hinzu. Erstelle src/components/GoogleReviews.astro, das GET https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 mit dem Header "Authorization: Bearer" sowie der Umgebungsvariable REVIEWFLOWZ_KEY. In den Frontmatter der Komponente eintragen, sodass er zur Bauzeit ausgeführt wird und der Schlüssel nie den Browser erreicht. Zeige Bewertung, Text, Rezensenten-Namen und "Auf Google lesen"-Link zu deren URL an. Nutze die Checkliste unter https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

Möchtest du alle Optionen, Filter und Webhooks an einem Ort haben? Lies Erstelle einen Testimonial-Feed für jede Seite. Nutzt du lieber WordPress? Einbettung eines Bewertungs-Widgets in WordPress.

Hat dies deine Frage beantwortet?