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.

Introdução

O plugin Integração com as Avaliações do Google permite exibir avaliações do Google Maps diretamente na página de detalhes das suas listagens. Isso ajuda a gerar mais confiança, aumentar a credibilidade e oferecer prova social real vinda do Google para os visitantes do seu site.

O plugin utiliza dados oficiais da Google Places API (New) e exibe um conjunto limitado de avaliações junto com informações importantes do negócio, totalmente integrado ao seu site eDirectory.

O que este plugin faz

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

⭐ Nota média

👥 Quantidade total de avaliações

🔗 Link para a página do estabelecimento no Google Maps

🌍 Suporte a idioma e região, com base no local do site

🔄 Opção de ordenação para os visitantes:

• Mais relevantes
• Mais recentes

Requisitos

Antes de utilizar este plugin, você precisa ter:

• Uma conta no Google Cloud Platform (GCP)
• Faturamento ativado no projeto do GCP (obrigatório pelo Google)
• Uma chave da Google Places API (New)
• Acesso ao painel administrativo do eDirectory (sitemgr)

Como configurar o plugin

Etapa 1: Criar uma chave da Google Places API

1. Acesse o Google Cloud Platform's API Console.
2. Crie um novo projeto ou selecione um projeto existente

3. Ative o Faturamento do projeto

• Para habilitar o faturamento, consulte este artigo: Como habilitar o faturamento

4. Acesse Library (Biblioteca)

5. Procure por Places API (New) e clique nela

6. Clique em Enable (Ativar)

7. Em seguida, vá para APIs & Services. Click neste link para acessar: Google Cloud Platform's API Console.
8. Clique em Credentials (Credenciais)

9. Clique em Create Credentials e depois em Create an API Key

Etapa 2: Restringir a chave da API (Obrigatório)

Para evitar uso indevido e custos inesperados, é obrigatório restringir sua chave de API.

Restrição por endereço IP

1. Dê um nome à chave, por exemplo: Avaliações do Google
2. Selecione IP addresses (web servers, cron jobs, etc.)
3. Adicione o(s) endereço(s) IP do servidor onde o eDirectory está hospedado

⚠️ Sem essa restrição, terceiros podem utilizar sua chave de API, gerando requisições indevidas e custos inesperados.

Restrição adicional recomendada

• Em API restrictions, permita somente a Places API (New)
• Clique em Create

• Após clicar em Create, a chave da API será exibida. Copie a chave.

Etapa 3: Adicionar a chave da API no eDirectory

1. Faça login na área administrativa (sitemgr)
2. Acesse Configurações >Congifurações gerais > Plugins

3. Localize as configurações do plugin de Avaliações do Google

4. Cole a chave da API no campo de Avaliações do Google
5. Salve as alterações
6. Vá até Conteúdo > Anúncios > Modelos de Anúncio
7. Escolha um modelo para editar

8. Clique para adicionar um widget e selecione o widget Avaliações com o Google

9. Salve as alterações

10. Após a configuração, as avaliações passarão a ser exibidas nas listagens.

Custos da API do Google: O que você precisa saber

O Google cobra por solicitação à API, com base no uso e nos dados solicitados. Com este plugin, normalmente ocorrem as seguintes chamadas:

A) Text Search (para encontrar o Place ID)

• Endpoint: places:searchText
• Nível de cobrança (SKU): Text Search Pro
• Usado para localizar a empresa com base no nome e endereço.

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

• Endpoint: /v1/places/{placeId}

  Quando as avaliações são solicitadas:

  • Nível de cobrança (SKU): Place Details Enterprise + Atmosphere
• Esta é a parte de maior custo da integração.

C) Fallback (sem avaliações)

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

• Nível de cobrança (SKU): Place Details Enterprise
• Somente a classificação e a quantidade de avaliações são obtidas.

📌 Resumo prático

Uma página de detalhes de um anúncio com avaliações habilitadas normalmente aciona:

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

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

Onde consultar os preços

Os preços do Google variam de acordo com a região e o volume de uso. Para consultar os preços atualizados, acesse a página de Preços do Google Maps Platform e procure por:

• 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
• 🏠 Certifique-se de que as listagens tenham endereços completos e precisos
• 📊 Monitore o uso em GCP → Billing → Reports
• 🚨 Configure alertas de cobrança e orçamentos no Google Cloud

Perguntas frequentes

1) Como um anúncio é associada a um Google Business Profile?

O plugin pesquisa o perfil da empresa usando uma combinação de:

• Título do anúncio
• Linhas do endereço
• Cidade / região / país
• CEP / código postal
• Informações adicionais de localização

A qualidade da correspondência depende principalmente da precisão e da integridade dos dados do anúncio.

✅ Se o anúncio tiver o nome correto da empresa e o endereço completo, a probabilidade de uma correspondência incorreta é baixa.

⚠️ Se os dados do anúncio estiverem incompletos ou forem ambíguos (nome genérico, CEP/cidade ausente, várias empresas com o mesmo nome), a possibilidade de correspondência incorreta aumenta.

2) Podemos exibir mais de 5 avaliações?

Não. A Google Places API retorna no máximo 5 avaliações em sua resposta. Essa limitação é definida pelo comportamento da API do Google, e não pelo nosso widget ou pela interface.

3) Como as avaliações são importadas? O patrocinador ou o sitemgr precisa fazer algo manualmente?

Não existe um processo de importação manual. As avaliações são recuperadas do Google sob demanda e exibidas automaticamente no widget da página de detalhes do anúncio.

Visão geral operacional:

• Administrador: configura as credenciais da API do Google uma única vez.
• Anunciante: normalmente não precisa fazer nada, desde que os dados do anúncio estejam corretos.

O widget carrega os dados das avaliações em segundo plano (via AJAX) quando a página de detalhes do anúncio é acessado.

4) O plugin afeta o posicionamento no Google?

Não diretamente. Exibir avaliações do Google em uma página não é um fator de posicionamento garantido nem representa um aumento garantido de SEO.

O que isso pode ajudar:

• Melhorar a confiança e a conversão (prova social)
• Potencialmente contribuir para sinais indiretos de engajamento

No entanto, o impacto no posicionamento não é previsível e não deve ser prometido.

5) Alguma informação é armazenada localmente?

Nós não armazenamos o conteúdo das avaliações localmente. Armazenamos apenas o place_id (o identificador exclusivo do Google Business Profile). Isso evita a necessidade de executar repetidamente a etapa de descoberta, o que:

• Reduz o uso da API
• Melhora o desempenho
• Melhora a consistência da correspondência

6) Como o Google cobra pelo uso? Existe risco de cobrança excedente devido a bots?

O Google cobra por solicitação à API ("evento faturável"), dependendo do endpoint do Places utilizado (por exemplo, pesquisa ou detalhes).

O plugin normalmente aciona:

• Uma solicitação única (ou ocasional) de "encontrar o local" caso não exista um place_id
• Uma solicitação de Place Details cada vez que a página de detalhes do anúncio é carregado e o widget busca os dados de classificação/avaliações

O Google não cobra por avaliação — a cobrança é feita por chamada à API.

Exemplo de estimativa (nível Essentials)

• Place Details (Essentials): ~US$ 5 por 1.000 solicitações (após a franquia mensal gratuita)

Exemplo:

• 10.000 carregamentos do widget ≈ US$ 50
• 100.000 carregamentos do widget ≈ US$ 500

Os custos reais variam de acordo com a região e o volume.

Picos de bots e risco de cobrança excedente

O widget é carregado em segundo plano via AJAX.

Muitos bots não executam JavaScript e, portanto, podem não acionar chamadas à API. No entanto, isso não pode ser garantido — bots sofisticados ainda podem gerar solicitações.

Proteções recomendadas:

• Restrinja sua chave de API (por IP e/ou por referenciador)
• Defina limites de cota para a Places API
• Configure alertas de cobrança e orçamentos no Google Cloud
• Monitore os relatórios de uso regularmente
• Utilize WAF ou proteção contra bots caso ocorram picos recorrentes de bots

7) O Google cobra "por avaliação"?

Não. O Google cobra por solicitação à Place Details API, que pode incluir:

• Classificação
• Quantidade de avaliações
• Até 5 avaliações

O fator que determina o custo é:

O número de vezes que o widget é carregado

(e não o número de avaliações que uma empresa possui)

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

Os possíveis motivos incluem:

• A empresa não pode ser encontrada (título/endereço incompleto ou incorreto)
• A empresa não possui avaliações públicas no Google
• Restrições da chave de API ou permissões ausentes
• O faturamento não está habilitado no Google Cloud
• As cotas ou limites da API foram atingidos

9) Qual é a precisão da correspondência do perfil?

A correspondência é baseada em:

• Título do anúncio
• Campos de endereço
• Hierarquia de localização
• CEP/código postal

Com informações completas e precisas no anúncio, a probabilidade de uma correspondência incorreta é baixa.

Os maiores riscos são:

• Endereços incompletos
• CEP/cidade ausentes
• Empresas com nomes muito semelhantes na mesma região

Solução de problemas

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

Verifique se:

• A Google Places API (New) está habilitada.
• O faturamento está habilitado no Google Cloud.
• A chave da API foi inserida corretamente no eDirectory.
• A chave da API não está configurada com restrições incorretas.
• Os endereços IP corretos do servidor foram adicionados à chave da API.
• A Places API (New) está permitida nas restrições da API.
• O widget de avaliações do Google foi adicionado ao template do anúncio.
• O anúncio contém o nome da empresa e o endereço completos e precisos.
• A empresa possui avaliações públicas disponíveis 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 Google Business Profile correspondente.

Verifique os seguintes dados do anúncio afetado:

• Nome da empresa
• Endereço
• Cidade
• Região
• País
• CEP ou código postal

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

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

Esse é o 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 recuperadas 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 template do 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 representa um aumento garantido 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 nos resultados de pesquisa é indireto e não pode ser garantido.

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

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

A integração armazena o place_id, que é o identificador exclusivo associado ao Google Business Profile.

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 de Place Details pode incluir:

• Classificação da empresa
• Quantidade 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

O plugin de Integração com as Avaliações do Google é uma excelente forma de enriquecer suas listagens com avaliações reais e confiáveis do Google. Com a configuração correta e as restrições adequadas da chave de API, ele oferece grande valor ao site mantendo os custos sob controle.

Se precisar de ajuda para configurar sua chave de API, restrições de IP do servidor ou posicionamento do widget, nossa equipe de suporte está à disposição para ajudar.