Ir para conteúdo principal

Como adicionar avaliações do Google ao seu site Astro

Incorpore facilmente avaliações do Google ao seu site Astro usando código e IA.

A
Escrito por Axel Lavergne

Para exibir avaliações do Google no seu site Astro, a melhor solução é obtê-las de uma API de avaliações quando o site é montado e depois reconstruí-lo em uma rotina. As avaliações são integradas ao seu HTML estático, garantindo que a página continue rápida, que os motores de busca consigam lê-las e que sua chave API não seja exposta ao navegador. O código está ao final, acompanhado de um prompt para você compartilhar com seu assistente de codificação de IA. Antes de colar, quatro escolhas influenciam a eficácia do procedimento, portanto, tome cuidado ao decidir.

TLDR

  • A melhor forma de mostrar avaliações do Google em um site Astro é buscá-las em uma API de avaliações quando o site é montado, assim as avaliações ficam no seu HTML estático e a sua chave de API nunca chega ao navegador.

  • A API do Reviewflowz busca suas avaliações do Google sem acesso ao Google Business Profile e sem aprovação do Google, e a mesma API retorna avaliações de mais de 200 plataformas nos mesmos campos.

  • Um widget de avaliações do Reviewflowz é um único iframe que você personaliza livremente, assim você mostra avaliações do Google sempre atualizadas em um site Astro sem precisar reconstruí-lo.

  • As tags do Reviewflowz permitem que cada página do seu site peça apenas as avaliações que combinam com ela, quer você marque as avaliações à mão, quer deixe a IA marcar.

Quando capturar as avaliações: na montagem, ao carregar a página ou através de um iframe

Existem três momentos para integrar as avaliações em uma página, e cada uma delas equilibra velocidade, atualidade e indexação de forma diferente.

Opção

Como funciona

A troca

Na montagem

O Astro coleta as avaliações durante a montagem do site e as grava no HTML.

É a maneira mais rápida, eficiente e eficaz. As avaliações estão tão recentes quanto sua última construção, então, se você não publica com frequência, configure para reconstruir diariamente ou semanalmente.

Assíncrono ao carregar a página

Um script carrega as avaliações após a abertura da página.

Impacta a forma como a página é indexada e lida.

Iframe ao carregar a página

A página inclui um widget de avaliações em um iframe.

Soluciona bem: mantém-se atual e ainda extremamente rápida, pois o widget é carregado de forma estática.

No Astro, a montagem é a melhor opção. O código no frontmatter de um componente é executado quando o site é construído, o que significa que as avaliações vêm como HTML puro quando alguém abre a página, mantendo a chave apenas em sua máquina ou no servidor de construção.

O iframe, sem construí-lo. O widget de avaliações da Reviewflowz é personalizável e se mantém atualizado, sendo carregado de forma estática, o que o torna extremamente rápido. Está disponível em Integrações, aba Widgets.

Fonte das avaliações: API de Locais, API de Perfil de Empresa, ou uma API de terceiros

A escolha da fonte define quantas avaliações poderá exibir e quantas etapas estão envolvidas até a primeira avaliação.

Fonte

O que você recebe

Requisitos

Google Places API

5 avaliações, uma amostra aleatória, podendo ser mais antigas.

Uma chave da API do Google Cloud.

Google Business Profile API

Todas as avaliações do seu perfil de empresa.

Aprovação inicial: solicite acesso, o Google revisa em até 14 dias. Depois, OAuth com proprietário ou gerente.

API de avaliação de terceiros

Todas as suas avaliações de várias plataformas.

Uma chave API. Não necessita acesso ao Perfil de Empresa.

Cinco avaliações não são suficientes. Portanto, você precisa de acesso ao Perfil de Empresa com aprovação do Google ou de um serviço que faça isso por você.

Sem necessidade de acesso ao Perfil de Empresa. A API Reviewflowz recupera suas avaliações do Google sem necessidade de acesso ao Perfil de Empresa ou aprovação, abrangendo mais de 200 plataformas. Veja aqui o que retorna para o Google.

Quais avaliações exibir

Mostrar todas as avaliações é a opção mais direta, mas nem sempre a melhor. Decida isso antes de escrever qualquer código:

  • Mostrar todas ou apenas algumas?

  • Selecioná-las manualmente ou automaticamente?

  • Aplicar regras: nota mínima, texto obrigatório, mais recentes primeiro?

  • Filtrar por tópico, localidade, idioma ou outro critério?

O código abaixo seleciona automaticamente com regras definidas: 6 avaliações de 5 estrelas com texto, ainda no Google, mais recentes. Cada regra está comentada para você ajustar conforme necessário. Três filtros adicionais estão disponíveis: language=en para idioma, location=<id> para localidade e tag=<id> para marcas feitas manualmente ou por IA.

Escolha avaliações por página com tags. No Reviewflowz, marque avaliações manualmente ou deixe a IA etiquetá-las. Assim, cada página solicita sua tag à API. A Lugg construiu sua página de avaliações desta maneira, permitindo que os visitantes escolham um caso de uso e cidade e leiam especificamente sobre isso, com 6 a 9% dos novos visitantes acessando a página de avaliações primeiro. O guia de feeds de depoimentos ensina a configuração.

Avaliações do Tripadvisor, Trustpilot e outras plataformas

Se quiser mais do que o Google, também precisará de uma API de terceiros. Algumas plataformas, como o Tripadvisor, proíbem o uso de suas avaliações no seu site, mas na prática, poucas pessoas se importam. É sempre uma boa prática criar um link que leva para a avaliação original, evitando reclamações.

O código abaixo faz isso para o Google: cada avaliação inclui uma url que a abre no Google, e o componente mostra isso como um link "Ler no Google", para que os visitantes possam verificar a autenticidade.

Outras plataformas, mesma solicitação. Com o Reviewflowz, Tripadvisor, Trustpilot, e outras vêm na mesma requisição: só modifique o platform, e as avaliações vêm nos mesmos campos, cada uma com sua própria url para criar o link. O guia de feeds de depoimentos lista todos os filtros.

Passo a passo para adicionar avaliações do Google ao seu site Astro

Passo 1. No Reviewflowz, vá para Fontes de Avaliação e clique em Nova fonte de avaliação. Escolha Google Maps, procure seu negócio e selecione-o.

A página Nova fonte de avaliação com o Google Maps selecionado e um negócio encontrado pelo nome

Passo 2. Vá para Configurações → Webhooks & API e clique em Criar uma chave API. Dê um nome, escolha Apenas leitura e crie. A API faz parte do plano Premium.

A janela Criar uma chave API com a permissão Apenas leitura selecionada

Passo 3. Coloque a chave no arquivo .env na raiz do seu projeto como REVIEWFLOWZ_KEY. Adicione a mesma variável nas variáveis de ambiente do seu servidor de construção, para permitir leitura durante a construção. Passo 4. Crie src/components/GoogleReviews.astro e insira o seguinte:

---
// src/components/GoogleReviews.astro
// Executa quando o site é construído: a chave permanece na sua máquina ou servidor de construção,
// nunca na página. Coloque REVIEWFLOWZ_KEY=rfz_live_... no seu arquivo .env.
const params = new URLSearchParams({
platform: "google_maps", // Apenas avaliações do Google
rating_min: "5", // 5 estrelas
has_text: "true", // com texto escrito
removed: "false", // ainda no Google
sort: "date", // mais recentes primeiro
limit: "6", // quantas mostrar
});

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">Ler no Google</a>}
</figcaption>
</figure>
))}
</section>

Passo 5. Importe o componente em qualquer página e adicione <GoogleReviews /> onde deseja que as avaliações apareçam. Passo 6. Mantenha-o atualizado: reconstrua o site diariamente, semanalmente, ou quando um webhook notificar seu servidor sobre uma nova avaliação.

Prompt para seu agente de codificação de IA: Adicione uma seção de avaliações do Google a este site Astro. Crie src/components/GoogleReviews.astro que busca GET https://api.reviewflowz.com/v3/reviews?platform=google_maps&rating_min=5&has_text=true&removed=false&sort=date&limit=6 com o cabeçalho "Authorization: Bearer" mais a variável de ambiente REVIEWFLOWZ_KEY. Buscar no componente frontmatter, para que ele seja executado no momento da construção e a chave nunca chegue ao navegador. Mostre a avaliação, o texto, o nome do avaliador e um link "Ler no Google" para sua url. Siga a lista de verificação em https://api.reviewflowz.com/v3/docs/guides/testimonial-feeds.

Quer todas as opções, filtros e webhooks em um só lugar? Leia Como construir um feed de depoimentos para cada página. Usa WordPress? Saiba como incorporar um widget de avaliação no WordPress.

Isto respondeu à sua pergunta?