Vai al contenuto principale

Come aggiungere le recensioni di Google al tuo sito Next.js

Mostra le recensioni di Google sul tuo sito Next.js facilmente.

A
Scritto da Axel Lavergne

Per mostrare al meglio le recensioni di Google su un sito Next.js, ti consiglio di recuperarle tramite un’API di recensioni direttamente in una componente server. Next.js può quindi aggiornare le recensioni al massimo una volta ogni ora. In questo modo, le recensioni verranno incluse nell'HTML, rendendo la pagina veloce, facilmente leggibile dai motori di ricerca e la tua chiave API non sarà mai visibile nel browser. Se il tuo sito è stato costruito con Vercel v0, utilizza Next.js, rendendo questa modalità compatibile. Alla fine dell'articolo troverai del codice utile, insieme a un prompt da usare per il tuo agente di codifica AI. Prima di utilizzarlo, tieni a mente quattro fattori che influenzeranno il successo del processo.

TLDR

  • Il modo migliore per mostrare le recensioni di Google su un sito Next.js è recuperarle da un'API di recensioni in una componente server, così le recensioni arrivano nell'HTML 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 Next.js senza scrivere codice di recupero.

  • 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: al build, al caricamento della pagina o in un iframe

Hai tre opzioni per inserire le recensioni in una pagina, ognuna con un diverso bilanciamento tra velocità, freschezza e indicizzazione.

Opzione

Come funziona

Il compromesso

Alla build

Il server recupera le recensioni e le include nell'HTML.

È il metodo più veloce e efficiente. Le recensioni sono aggiornate quanto l'ultimo recupero: pianifica bene come aggiornarle.

Asincrono al caricamento della pagina

Uno script carica le recensioni dopo che la pagina è aperta.

Potrebbe influenzare l'indicizzazione e la lettura da parte dei motori di ricerca.

Iframe al caricamento della pagina

La pagina integra un widget di recensioni in un iframe.

Buon compromesso: recensioni sempre fresche e pagina veloce, grazie al caricamento statico del widget.

Con una componente server di Next.js, puoi scegliere la prima opzione senza dover ricostruire. Poiché funziona sul server, le recensioni sono incluse nell'HTML mentre la chiave API rimane sicura, e revalidate permette di aggiornarle una volta all'ora.

L'iframe, senza costruirlo. Il widget di recensioni di Reviewflowz è un iframe totalmente personalizzabile. Lo manteniamo aggiornato e caricato staticamente, garantendo velocità elevate. Trovi questa funzione in Integrazioni, nella sezione Widgets.

Da dove provengono le recensioni: API Places, API Profilo Aziendale o un'API recensioni

La provenienza delle recensioni influirà sul numero di recensioni mostrabili e sul setup necessario.

Fonte

Cosa ottieni

Cosa serve

API Google Places

5 recensioni scelte casualmente, che potrebbero essere vecchie o negative.

Una chiave API di Google Cloud.

API Profilo Aziendale di Google

Disponibilità di tutte le recensioni del tuo profilo aziendale.

Pre-approvazione: occorre richiedere l'accesso e attendere fino a 14 giorni per la valutazione da parte di Google. Successivamente, OAuth per accesso riservato al proprietario o gestore del profilo.

Un'altra API di recensioni

Tutte le recensioni tue e di piattaforme diverse.

Una semplice chiave API. Non serve accedere al Profilo Aziendale.

Mostrare solo cinque recensioni è limitante. Perciò, normalmente avrai bisogno dell'accesso al Profilo Aziendale tramite l'approvazione di Google o un servizio che gestisca questo per te.

Non serve l'accesso al Profilo Aziendale. L'API di Reviewflowz raccoglie le tue recensioni di Google senza necessità di accesso al Profilo Aziendale e senza l'approvazione di Google, e la stessa API copre oltre 200 piattaforme con statistiche equivalenti. Ecco cosa mostra per Google.

Quali recensioni mostrare

Mostrare ogni recensione è semplice ma spesso non la scelta ideale. Considera questi aspetti prima di scrivere il codice:

  • Mostrare tutte le recensioni o solo una selezione?

  • Selezione manuale o automatica?

  • Applica regole: punteggio minimo, testo richiesto, ordinamento per data?

  • Filtra per argomento, luogo, lingua o in base alla pagina?

Il codice qui di seguito effettua una selezione automatica seguendo alcune regole: 6 recensioni, 5 stelle, con testo, ancora presenti su Google, ordinate per le più recenti. Ogni regola è commentata per permetterti modifiche rapide. Inoltre, ci sono tre criteri extra: language=en per le recensioni in una lingua specifica, location=<id> per una delle tue sedi, e tag=<id> per recensire manualmente o con tag AI.

Seleziona recensioni per pagina con tag. In Reviewflowz puoi scegliere di taggare le recensioni manualmente, o lasciare che il tag AI faccia il lavoro, consentendo a ogni pagina di chiedere il proprio tag all'API. Lugg ha creato la sua pagina di recensioni seguendo questa filosofia: i visitatori scelgono un caso d'uso e una città e leggono recensioni specifiche, circa il 6-9% dei nuovi utenti di Lugg visitano prima la pagina delle recensioni. La guida al feed dei testimonial ti mostra le impostazioni.

Recensioni da Tripadvisor, Trustpilot e altre piattaforme

Se vuoi più recensioni oltre a Google, servirà una terza API. Alcune piattaforme, tipo Tripadvisor, non consentono l'uso delle loro recensioni sui tuoi siti. Per la maggior parte delle persone non è un problema. Tuttavia, è consigliabile collegarti alla recensione originale, per evitare reclami da parte delle piattaforme.

Il seguente codice lo fa per Google: ciascuna recensione include un url che la apre su Google, e la componente lo mostra come un link "Leggi su Google", così i visitatori possono verificarne l'autenticità.

Altre piattaforme, stessa procedura. Con Reviewflowz, Tripadvisor, Trustpilot e le altre seguono lo stesso processo: cambia platform e otterrai le recensioni negli stessi campi, con ognuna il suo url per il collegamento. La guida al feed dei testimonial elenca tutti i filtri disponibili.

Aggiungi le recensioni di Google al tuo sito Next.js, passo dopo passo

Passo 1. In Reviewflowz, apri Sorgenti Recensioni e clicca su Nuova sorgente recensione. Seleziona Google Maps, ricerca la tua attività e selezionala.

La pagina Nuova sorgente recensione con Google Maps selezionato e un'attività trovata per nome

Passo 2. Vai su Impostazioni → Webhook & API e clicca su Crea una chiave API. Assegna un nome, seleziona Solo lettura e crea la chiave. L'API è parte del piano Premium.

La finestra Crea una chiave API con il permesso Solo lettura selezionato

Passo 3. Inserisci la chiave in .env.local come REVIEWFLOWZ_KEY, e aggiungi la stessa variabile nelle impostazioni dell'ambiente del tuo host (su Vercel, nelle impostazioni del progetto). Passo 4. Crea app/components/GoogleReviews.tsx e incolla quanto segue:

// app/components/GoogleReviews.tsx
// Una componente server: opera sul server, così la chiave non viene mai inviata
// al browser. Inserisci REVIEWFLOWZ_KEY=rfz_live_... in .env.local (e nelle variabili
// d'ambiente del tuo host, come in quelle di Vercel).

type Review = {
id: string;
rating: number;
text: string | null;
reviewer: { name: string | null };
url: string | null;
};

export default async function GoogleReviews() {
const params = new URLSearchParams({
platform: "google_maps", // Solo recensioni Google
rating_min: "5", // 5 stelle
has_text: "true", // con testo
removed: "false", // ancora su Google
sort: "date", // le più recenti per prime
limit: "6", // quante mostrare
});

const res = await fetch(`https://api.reviewflowz.com/v3/reviews?${params}`, {
headers: { Authorization: `Bearer ${process.env.REVIEWFLOWZ_KEY}` },
next: { revalidate: 3600 }, // preleva di nuovo al massimo una volta all'ora
});
if (!res.ok) throw new Error(`Reviewflowz API ${res.status}: ${await res.text()}`);
const { data: reviews }: { data: Review[] } = await res.json();

return (
<section className="google-reviews">
{reviews.map((review) => (
<figure key={review.id}>
<p aria-label={`${review.rating} su 5 stelle`}>{"★".repeat(Math.round(review.rating))}</p>
<blockquote>{review.text}</blockquote>
<figcaption>
{review.reviewer.name}
{review.url && <a href={review.url} target="_blank" rel="noopener">Leggi su Google</a>}
</figcaption>
</figure>
))}
</section>
);
}

Passo 5. Importa la componente nella pagina desiderata e inserisci <GoogleReviews /> dove vuoi che appaiano le recensioni. Passo 6. Questa impostazione gestisce l'aggiornamento: revalidate: 3600 fa sì che si prelevino di nuovo le recensioni al massimo una volta all'ora. L'API invia un ETag, e un riscontro 304 è considerato una chiamata, con un limite di 300 chiamate al minuto per account.

Prompt per il tuo agente di codifica AI: Aggiungi una sezione per le recensioni di Google su questo sito Next.js. Crea app/components/GoogleReviews.tsx come una componente server che recupera dati con GET da https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 utilizzando l'intestazione "Authorization: Bearer" con la variabile d'ambiente REVIEWFLOWZ_KEY, e next: { revalidate: 3600 }. Mantienila una componente server, per cui la chiave non raggiunge il browser. Visualizza il punteggio, il testo, il nome dell'autore e un link "Leggi su Google" all'url corrispondente. Segui la checklist su https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

Vuoi avere ogni opzione, filtro e webhook a portata di mano? Consulta Costruisci un feed di testimonial per ogni pagina. Gestisci un sito WordPress invece? Scopri come Incorporare un widget di recensioni su WordPress.

Hai ricevuto la risposta alla tua domanda?