Vai al contenuto principale

Come aggiungere le recensioni di Google al tuo sito Astro

Importa recensioni Google sul tuo sito Astro con codice e un prompt per il tuo agente AI.

A
Scritto da Axel Lavergne

Il miglior modo per mostrare le recensioni di Google su un sito Astro è recuperarle tramite un'API di recensioni durante la costruzione del sito, ricostruendolo poi periodicamente. In questo modo, le recensioni vengono integrate nel tuo HTML statico, mantenendo la pagina veloce e leggibile dai motori di ricerca, senza esporre la chiave API al browser. Troverai il codice alla fine, insieme a un prompt da utilizzare con il tuo agente AI. Prima di incollarlo, considera attentamente le quattro decisioni che influenzeranno il funzionamento.

TLDR

  • Il modo migliore per mostrare le recensioni di Google su un sito Astro è recuperarle da un'API di recensioni durante la costruzione del sito, così le recensioni finiscono nell'HTML statico e la tua chiave API non raggiunge mai il browser.

  • L'API di Reviewflowz recupera le tue recensioni Google senza accesso a Google Business Profile e senza l'approvazione di Google, e la stessa API restituisce recensioni da oltre 200 piattaforme negli stessi campi.

  • Un widget di recensioni di Reviewflowz è un unico iframe che personalizzi liberamente, così mostri recensioni Google sempre aggiornate su un sito Astro senza doverlo ricostruire.

  • I tag di Reviewflowz permettono a ogni pagina del tuo sito di chiedere solo le recensioni adatte, che tu le tagghi a mano o lasci farlo all'IA.

Quando recuperare le recensioni: alla costruzione, al caricamento della pagina o tramite iframe

Ci sono tre modalità per inserire le recensioni in una pagina, ciascuna con un diverso equilibrio tra velocità, freschezza e indicizzazione.

Opzione

Come funziona

Il compromesso

Alla costruzione

Astro raccoglie le recensioni durante la costruzione del sito e le inserisce nell'HTML.

È il metodo più veloce ed efficiente. Le recensioni sono aggiornate all'ultima ricostruzione del sito, quindi aggiorna regolarmente se non pubblichi spesso.

Async al caricamento della pagina

Uno script carica le recensioni una volta aperta la pagina.

Rallenta l'indicizzazione e la leggibilità della pagina.

Iframe al caricamento della pagina

La pagina include un widget di recensioni tramite iframe.

Un buon compromesso: recensioni sempre fresche e caricamento veloce, grazie al widget statico.

In Astro, la costruzione è la scelta top. Il codice nel frontmatter di un componente gira durante la costruzione del sito, rendendo le recensioni HTML semplice quando un utente visita la pagina, mantenendo la chiave sicura sul tuo server.

L'iframe, senza costruirlo. Il widget di recensioni di Reviewflowz è un iframe che puoi personalizzare al massimo. Lo manteniamo aggiornato e caricabile staticamente, assicurando velocità notevole. Lo trovi nella sezione Integrazioni, alla voce Widget.

Da dove riprendere le recensioni: Places API, Business Profile API, o un'API di recensione

La scelta della fonte determina quante recensioni puoi mostrare e il setup necessario per partire.

Fonte

Cosa ottieni

Cosa serve

Google Places API

5 recensioni, campionate casualmente. Possono essere datate e negative.

Una chiave API di Google Cloud.

Google Business Profile API

Tutte le recensioni del tuo profilo.

Approvazione iniziale: richiedi l'accesso e Google risponde in 14 giorni. Poi OAuth come proprietario o gestore.

Un'API di recensione di terze parti

Tutte le tue recensioni e anche quelle di altre piattaforme.

Una chiave API. Non serve l'accesso al Business Profile.

Cinque recensioni non bastano. Quindi, di solito, serve l'approvazione di Google per l'accesso a Business Profile o un servizio che lo gestisca.

Non occorre l'accesso a Business Profile. L'API Reviewflowz raccoglie le recensioni di Google senza richiedere l'accesso a Business Profile né l'approvazione di Google, e la stessa API offre supporto per oltre 200 piattaforme con gli stessi campi. Ecco cosa restituisce per Google.

Quali recensioni mostrare

Mostrare tutte le recensioni è semplice, ma non sempre la scelta migliore. Considera questi punti prima di iniziare a scrivere codice:

  • Mostri tutte le recensioni o solo alcune?

  • Le selezioni manualmente o automaticamente?

  • Applichi regole come una valutazione minima, testo richiesto, ordine cronologico?

  • Filtri per argomento, posizione o lingua adatti alla pagina?

Il codice seguente seleziona recensioni automaticamente con regole: 6 recensioni, 5 stelle, con testo, ancora su Google e in ordine dalla più recente. Ogni regola è commentata, così puoi apportare modifiche facilmente. Sono disponibili tre filtri aggiuntivi: language=en per la lingua, location=<id> per la tua posizione e tag=<id> per recensioni selezionate a mano o tramite tag AI.

Scegli recensori con i tag. Su Reviewflowz, puoi taggare manualmente le recensioni o lasciare che l'AI lo faccia. Ogni pagina chiede all'API il suo tag specifico. Lugg ha costruito la sua pagina di recensioni così: i visitatori scelgono un uso o una città e vedono recensioni pertinenti. Circa il 6-9% dei nuovi utenti di Lugg arriva prima su una pagina di recensioni. Consulta la guida al feed delle testimonianze per vedere la configurazione.

Recensioni da Tripadvisor, Trustpilot e altre piattaforme

Per aggiungere recensioni da altre piattaforme oltre Google, serve un'API di recensioni di terze parti. Alcuni servizi, come Tripadvisor, vietano l'uso delle loro recensioni direttamente sul tuo sito. Di solito, è una buona prassi linkare alla recensione originale, per evitare sanzioni.

Il codice seguente lo fa per Google: ogni recensione include un url che apre la recensione su Google, raffigurando un link "Leggi su Google" per verificare l'autenticità della recensione.

Altre piattaforme, stessa richiesta. Con Reviewflowz, Tripadvisor, Trustpilot e altri vengono gestiti con la stessa richiesta: cambia platform e le recensioni sono restituite negli stessi campi, con ogni url che ritorna alla fonte. Consulta la guida al feed delle testimonianze per un elenco completo dei filtri disponibili.

Aggiungere recensioni di Google al tuo sito Astro, passo dopo passo

Passo 1. In Reviewflowz, accedi a Fonti di recensioni e clicca su Nuova fonte di recensione. Scegli Google Maps, cerca la tua azienda e selezionala.

Pagina Nuova fonte di recensione con Google Maps selezionato e un'attività trovata per nome

Passo 2. Vai su Impostazioni → Webhooks & API e clicca su Crea una chiave API. Nominala, scegli Solo lettura e creala. L'API è inclusa nel piano Premium.

Finestra Crea una chiave API con permesso Solo lettura selezionato

Passo 3. Inserisci la chiave nel file .env alla radice del tuo progetto come REVIEWFLOWZ_KEY. Aggiungi la stessa variabile alle impostazioni d'ambiente del tuo server, per permettere la lettura durante la costruzione. Passo 4. Crea src/components/GoogleReviews.astro e incolla il codice seguente:

---
// src/components/GoogleReviews.astro
// Funziona durante la costruzione del sito: la chiave resta sicura sulla tua macchina o server,
// non raggiunge mai il browser. Inserisci REVIEWFLOWZ_KEY=rfz_live_... nel tuo file .env.
const params = new URLSearchParams({
platform: "google_maps", // Solo recensioni Google
rating_min: "5", // 5 stelle
has_text: "true", // con testo scritto
removed: "false", // ancora su Google
sort: "date", // più recenti prima
limit: "6", // numero da mostrare
});

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} out of 5 stars`}>{"★".repeat(Math.round(review.rating))}</p>
<blockquote>{review.text}</blockquote>
<figcaption>
{review.reviewer.name}
{review.url && <a href={review.url} target="_blank" rel="noopener">Read on Google</a>}
</figcaption>
</figure>
))}
</section>

Passo 5. Importa il componente in qualsiasi pagina e posiziona <GoogleReviews /> dove vuoi mostrare le recensioni. Passo 6. Mantieni il sito aggiornato: ricostruiscilo giornalmente o settimanalmente, oppure quando un webhook notifica al tuo server l'arrivo di una nuova recensione.

Prompt per il tuo agente AI di codifica: Aggiungi una sezione di recensioni Google a questo sito Astro. Crea src/components/GoogleReviews.astro che esegua una richiesta GET a https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 con l'intestazione "Authorization: Bearer" più la variabile d'ambiente REVIEWFLOWZ_KEY. Recupera nel frontmatter del componente, per eseguire al momento della costruzione e non esporre mai la chiave al browser. Mostra la valutazione, testo, nome del recensore e un link "Leggi su Google" per ciascuna recensione. Segui la checklist in https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

Vuoi tutte le opzioni, filtri e webhook in un unico posto? Leggi Costruisci un feed di testimonianze per ogni pagina. Usi WordPress, invece? Incorpora un widget di recensioni su WordPress.

Hai ricevuto la risposta alla tua domanda?