- O módulo exibe a pesquisa de avaliação do Google Customer Reviews na página de sucesso do checkout, logo após o cliente finalizar a compra.
- O cliente é convidado a participar do programa e, se aceitar, o Google envia depois um e-mail pedindo a avaliação da compra.
- Os dados do pedido (número, e-mail, país e prazo de entrega estimado) são preenchidos automaticamente — você só precisa configurar uma vez.
- Compatível com Magento 2.
Passo a Passo por Escrito
1. Acesse as configurações do módulo no painel administrativo
No painel da sua loja, acesse Lojas → Configuração → Vendas → Google API → Google Customer Reviews.
Resultado esperado: A seção Google Customer Reviews será exibida com o campo Habilitar disponível.
2. Habilite o módulo
No campo Habilitar, selecione Sim.
Ao selecionar Sim, os demais campos de configuração aparecem logo abaixo. Enquanto o módulo estiver como Não, nada é exibido na loja.
Resultado esperado: Os campos ID do Comerciante, País de Entrega, Prazo Estimado de Entrega (dias) e Código do Atributo de GTIN passam a ser exibidos.
3. Preencha o ID do Comerciante
No campo ID do Comerciante, informe o número da sua conta do Google Merchant Center (apenas números).
Exemplo: 123456789
Sem um ID do Comerciante válido, a pesquisa até é inserida na página, mas o Google não consegue associar os dados à sua conta e o cartão de avaliação não aparece. Se você ainda não tem esse número, crie ou acesse sua conta no Google Merchant Center para obtê-lo.
Resultado esperado: O campo exibe o número informado, aceitando apenas dígitos.
4. Preencha o País de Entrega
No campo País de Entrega, informe o código do país com duas letras (padrão ISO).
Exemplo: BR para Brasil.
Este campo é obrigatório. Use sempre o código de duas letras — BR, PT, US — e não o nome do país por extenso.
Resultado esperado: O campo exibe o código do país informado.
5. Defina o Prazo Estimado de Entrega (dias)
No campo Prazo Estimado de Entrega (dias), informe quantos dias, em média, um pedido leva para ser entregue.
Exemplo: 9
A partir desse número, a loja calcula automaticamente a data estimada de entrega de cada pedido (data da compra + os dias informados). Essa data é enviada ao Google para que o pedido de avaliação chegue ao cliente no momento certo.
Informe um número maior que zero. Valores em branco ou iguais a zero não geram uma data de entrega válida.
Resultado esperado: O campo exibe o número de dias informado.
6. Preencha o Código do Atributo de GTIN (opcional)
No campo Código do Atributo de GTIN, informe o código do atributo do produto onde você guarda o GTIN/EAN (o código de barras do produto).
Exemplos comuns: gtin, ean, barcode.
Este campo é opcional. Se você deixá-lo em branco, o módulo funciona normalmente — apenas não envia os códigos dos produtos ao Google. Preenchendo, o Google passa a associar as avaliações também aos produtos comprados.
Resultado esperado: O campo exibe o código do atributo informado (ou permanece em branco, se você optar por não usá-lo).
7. Salve e limpe o cache
Clique em Salvar Configuração no canto superior direito da tela.
Após salvar, limpe o cache da loja para que as alterações entrem em vigor. Acesse Sistema → Gerenciamento de Cache e clique em Liberar Cache de Armazenamento do Magento.
Resultado esperado: Uma mensagem de "Você salvou a configuração" é exibida no topo da tela.
Validação e Testes
Após concluir a configuração, execute os testes abaixo para confirmar o funcionamento correto.
Teste 1 — Finalize um pedido de teste
Ação: Faça uma compra completa na loja (do carrinho até a confirmação) e aguarde a exibição da página de sucesso do pedido ("Obrigado pela sua compra!").
Resultado esperado: A pesquisa de avaliação do Google Customer Reviews é apresentada na página de sucesso, convidando o cliente a participar do programa.
Teste 2 — Confirme que os dados do pedido foram enviados
Ação: Ainda na página de sucesso, verifique se a pesquisa reflete o pedido recém-criado (número do pedido, país e data estimada de entrega coerentes com o que você configurou).
Resultado esperado: A pesquisa carrega com os dados do pedido atual, sem erros na página.
Teste 3 — Confirme que o módulo respeita o "Habilitar"
Ação: Volte em Lojas → Configuração → Vendas → Google API → Google Customer Reviews, altere o campo Habilitar para Não, salve, limpe o cache e finalize um novo pedido de teste.
Resultado esperado: Com o módulo desabilitado, a pesquisa não aparece na página de sucesso. Ao habilitar novamente, ela volta a ser exibida.
Se não funcionar, verifique:
- O campo Habilitar está como Sim.
- O ID do Comerciante está preenchido corretamente, apenas com números.
- O cache da loja foi limpo após salvar as configurações.
- O ID do Comerciante corresponde a uma conta válida do Google Merchant Center inscrita no programa Google Customer Reviews (com um ID fictício, a pesquisa não é renderizada pelo Google).
Pronto! Dessa forma realizamos a configuração do Google Customer Reviews em sua loja virtual Magento 2.
Observações Importantes
- Onde a pesquisa aparece: exclusivamente na página de sucesso do checkout (após o pedido ser finalizado). Ela não é exibida em outras páginas da loja.
- Escopo das configurações: os campos podem ser definidos por site ou por visão de loja. Se você tem mais de uma loja, revise a configuração em cada uma.
- Campo de GTIN é opcional: sem ele, a integração continua funcionando; apenas os códigos de barras dos produtos deixam de ser enviados ao Google. Se o código do atributo informado estiver incorreto, a página continua funcionando normalmente e os produtos simplesmente não são enviados.
- Produtos sem GTIN preenchido: apenas os produtos que possuem o código preenchido são enviados. Produtos sem esse valor são ignorados, sem prejudicar o restante.
- ID fictício não renderiza o cartão: o cartão visual do Google só aparece quando o ID do Comerciante pertence a uma conta real inscrita no programa. Isso é um comportamento do próprio Google, não do módulo.
Referências e Relacionados
- Configuração de cache da loja: após qualquer alteração no módulo, é necessário limpar o cache para que as mudanças apareçam na loja.
- Atributos de produto: o módulo usa um atributo do produto para obter o GTIN/EAN. Esta doc ajuda a entender como criar e gerenciar atributos personalizados.
- Avaliações de produtos: entenda as opções nativas de avaliação da loja, que complementam as avaliações coletadas pelo Google.
Caso tenha ficado alguma dúvida entre em contato com nosso time de suporte através do chat online dentro da sua loja virtual ou através do e-mail web@tryideas.com.br