Plugin de Integração com as Avaliações do Google

Introdução

O plugin de Integração com as Avaliações do Google permite exibir avaliações do Google diretamente nas páginas de detalhes dos anúncios do seu eDirectory.

Exibir avaliações do Google pode ajudar a aumentar a confiança, melhorar a credibilidade e fornecer aos visitantes uma prova social diretamente do Google.

O plugin utiliza a Google Places API (New) para localizar a empresa e obter suas informações do Google. Depois de configurado, o widget pode exibir informações importantes, como a avaliação média da empresa, o número de avaliações e até 5 avaliações do Google.

Este guia mostrará como criar a chave de API necessária, configurar o plugin, adicionar o widget ao seu modelo de anúncio, entender os custos da API e solucionar problemas comuns.

Antes de começar

Antes de configurar o plugin de Integração com as Avaliações do Google, certifique-se de ter:

• Uma conta administrativa do eDirectory.
• Uma conta do Google Cloud Platform (GCP).
• Faturamento ativado no seu projeto do Google Cloud.
• Pelo menos um anúncio com informações comerciais precisas.

O que o widget Avaliações do Google exibe

Quando ativado, o plugin exibe até 5 avaliações do Google na página de detalhes do anúncio, incluindo:

• ⭐ Avaliação média
• 👥 Número total de avaliações
• 🔗 Link para a página da empresa no Google Maps
• 🌍 Suporte a idioma e região, com base na localidade do seu site
• 🔄 Opções de ordenação para os visitantes:
  • Mais relevantes
  • Mais recentes

Etapa 1: Criar uma chave da Google Places API

O primeiro passo é criar uma chave de API no Google Cloud Platform.

1.1. Acesse o Google Cloud Platform API Console

• Acesse o Google Cloud Platform API Console.
• Crie um novo projeto ou selecione um projeto existente.

• Se você já possui um projeto do Google Cloud para o seu site, certifique-se de que o projeto correto esteja selecionado antes de continuar.

1.2. Abra a Biblioteca de APIs

• No console do Google Cloud Platform, navegue até Biblioteca

• Pesquise por Places API (New)

• Clique em Places API (New) para abrir a página da API.

1.3. Ative a Places API (New)

• Clique em Ativar.

• Se o faturamento ainda não estiver configurado para o projeto selecionado do Google Cloud, o Google solicitará que você vincule uma conta de faturamento antes que a API possa ser ativada.
• Siga as instruções fornecidas pelo Google para vincular uma conta de faturamento existente ou criar uma nova conta de faturamento.

1.4. Crie a chave de API

• Depois que a Places API (New) estiver ativada, clique no menu.

• Navegue para APIs e serviços →  Credenciais

• Clique em Criar credenciais → Chave de API

Etapa 2: Restrinja a chave de API

A restrição da chave de API é obrigatória.

As restrições da API ajudam a impedir o uso não autorizado da sua chave e reduzem o risco de cobranças inesperadas no Google Cloud.

2.1. Configure a restrição do aplicativo

• Nome: Dê à chave um nome que facilite sua identificação. Por exemplo: Avaliações do Google
• Restrições de API: Selecione a API que você ativou na Etapa 1.3:  Places API (New)

• Restrições do aplicativo: Em restrições do aplicativo, selecione: Endereços IP
• Restrições de endereço IP: Adicione o(s) endereço(s) IP do servidor onde seu site eDirectory está hospedado.

2.2. Crie a chave

• Depois de configurar as restrições, clique em Criar.

• A chave de API será exibida.
• Clique na opção para copiar a chave de API.

• Mantenha a chave copiada disponível, pois você precisará adicioná-la ao seu site eDirectory na próxima etapa.

Etapa 3: Adicione a chave de API ao eDirectory

Agora que a chave da Google Places API foi criada e restringida, adicione-a ao seu site eDirectory.

3.1. Acesse as configurações do plugin

• Faça login na área administrativa do eDirectory.
• Navegue até Configurações → Configurações Gerais → Plugins.

• Localize as configurações do plugin Avaliações do Google.
• Cole a chave da API do Google que você copiou anteriormente no campo Avaliações do Google.
• Clique em Salvar alterações.

Etapa 4: Adicione o widget de Avaliações do Google

Depois de adicionar a chave da API, você precisa adicionar o widget de Avaliações do Google ao seu modelo de anúncio.

• Navegue até Conteúdo → Listagens → Modelos de anúncio
• Escolha o modelo de anúncio onde deseja que as avaliações do Google apareçam e clique em Editar.

4.1. Adicione o widget

• Clique em Adicionar um widget.
• Pesquise por Avaliações do Google.
• Adicione o widget Avaliações do Google ao local desejado no seu modelo de anúncio.

• Clique em Salvar alterações.

A seção Avaliações do Google estará disponível nas páginas de detalhes dos anúncios que utilizam esse modelo.

Etapa 5: Verifique a integração

Acesse uma página de detalhes de um anúncio onde o widget Avaliações do Google foi adicionado.

Verifique se:

• A seção Avaliações do Google é exibida.
• A avaliação da empresa é exibida.
• As avaliações disponíveis são exibidas.
• O link para o Google Maps funciona corretamente.

Se o anúncio tiver um Perfil da Empresa no Google correspondente e a API estiver configurada corretamente, as informações das avaliações do Google deverão ser carregadas automaticamente.

Custos da Google API: o que você precisa saber

O Google cobra por requisição de API, de acordo com o uso e os dados solicitados. Com este plugin, normalmente ocorrem as seguintes chamadas:

A) Text Search (para encontrar o Place ID)

• Endpoint: places:searchText      
• Tier (SKU) típico: Text Search Pro
• Usado para localizar o negócio com base no nome e endereço

B) Place Details (para buscar avaliações e dados)

• Endpoint: /v1/places/{placeId}      

  Quando avaliações são solicitadas:

  • Tier (SKU): Place Details Enterprise + Atmosphere
• Esta é a parte mais cara da integração

C) Fallback (sem avaliações)

Se as avaliações não puderem ser recuperadas:

• Tier (SKU): Place Details Enterprise
• Apenas a nota e a quantidade de avaliações são retornadas

📌 Resumo prático

Uma página de anúncio com avaliações habilitadas geralmente gera:

• 1 requisição Text Search Pro
• 1 requisição Place Details Enterprise + Atmosphere

A maior parte do custo vem do Place Details com avaliações.

Onde verificar os preços

Os valores variam conforme a região e o volume de uso. Para consultar os preços atualizados, acesse a página oficial de preços do Google Maps Platform e procure pelos SKUs:

• Places API – Text Search Pro
• Places API – Place Details Enterprise
• Places API – Place Details Enterprise + Atmosphere

Boas práticas para reduzir custos

• 🔐 Sempre restrinja sua chave de API por IP
• 🏠 Garanta que as listagens tenham endereço completo e correto
• 📊 Monitore o uso em GCP → Billing → Reports
• 🚨 Configure alertas e limites de orçamento no Google Cloud

Perguntas frequentes

O plugin exibe todas as avaliações do Google?

Não. A Google Places API retorna no máximo 5 avaliações. Para exibir todas, geralmente é necessário acesso ao Google Business Profile.

Funciona em aplicativos mobile?

Não. Este plugin se aplica apenas ao site, não a aplicativos mobile.

Por que algumas listagens não exibem avaliações?

Possíveis motivos:

• O negócio não foi encontrado (título ou endereço incompletos)
• O negócio não possui avaliações públicas no Google
• Restrições ou permissões incorretas na chave da API
• Billing não habilitado no Google Cloud
• Limites ou cotas da API atingidos

Solução de problemas

Minhas avaliações do Google não estão aparecendo.

Verifique se:

• A Google Places API (New) está ativada.
• O faturamento está ativado no Google Cloud.
• A chave da API foi inserida corretamente no eDirectory.
• A chave da API não está com restrições configuradas incorretamente.
• Os endereços IP corretos do servidor foram adicionados à chave da API.
• A Places API (New) está autorizada nas restrições da API.
• O widget Avaliações do Google foi adicionado ao modelo de anúncio.
• O anúncio contém um nome comercial e endereço completos e precisos.
• A empresa possui avaliações públicas no Google.

Algumas listagens exibem avaliações, mas outras não.

Isso pode acontecer quando o plugin não consegue encontrar com segurança o Perfil da Empresa no Google correspondente.

Verifique os seguintes dados do anúncio afetado:

• Nome da empresa
• Endereço
• Cidade
• Região
• País
• CEP

Verifique também se a empresa possui avaliações públicas no Google.

Não consigo exibir mais de 5 avaliações.

Esse comportamento é esperado.

A Google Places API (New) retorna no máximo 5 avaliações.

O widget do eDirectory não pode aumentar esse limite, pois ele é imposto pela API do Google.

Preciso importar as avaliações manualmente?

Não.

As avaliações são obtidas automaticamente do Google quando o widget solicita essas informações.

O Site Manager precisa apenas configurar as credenciais da API do Google e adicionar o widget ao modelo de anúncio.

O plugin afeta o posicionamento no Google?

Não diretamente.

Exibir avaliações do Google no seu site não é um fator de posicionamento garantido nem proporciona automaticamente um benefício de SEO.

No entanto, as avaliações podem ajudar a aumentar a confiança dos visitantes e potencialmente melhorar o engajamento e as conversões.

Qualquer impacto no posicionamento é indireto e não pode ser garantido.

As avaliações do Google são armazenadas no meu site?

O conteúdo das avaliações não é armazenado localmente.

A integração armazena o place_id, que é o identificador exclusivo associado ao Perfil da Empresa no Google.

Manter o Place ID ajuda a evitar a repetição do processo inicial de descoberta da empresa e pode:

• Reduzir o uso da API.
• Melhorar o desempenho.
• Proporcionar uma correspondência mais consistente da empresa.

O Google cobra por cada avaliação?

Não.

O Google cobra com base nas solicitações à API e no tipo de informação solicitada.

Por exemplo, uma solicitação Place Details pode incluir:

• Avaliação da empresa
• Número de avaliações
• Até 5 avaliações

O principal fator de custo é o número de solicitações à API, e não o número de avaliações que a empresa possui.

Conclusão

Parabéns!

Você configurou com sucesso o plugin de Integração com as Avaliações do Google no seu site eDirectory.

O plugin oferece uma maneira fácil de exibir informações confiáveis de avaliações do Google diretamente nas páginas de detalhes dos seus anúncios, sem a necessidade de importar avaliações manualmente.

Para obter os melhores resultados, certifique-se de que seus anúncios contenham informações comerciais completas e precisas, restrinja corretamente sua chave da API do Google e monitore regularmente o uso da API no Google Cloud.

Lembre-se de que o Google limita a integração a um máximo de 5 avaliações por empresa e cobra com base nas solicitações à API, e não no número de avaliações exibidas.

Se precisar de assistência para configurar sua chave da API do Google, identificar o endereço IP correto do servidor ou adicionar o widget de Avaliações do Google ao seu modelo de anúncio, entre em contato com nossa equipe de suporte pelo e-mail support@edirectory.com.