Com o módulo de permissão da pesquisa, o Google recebe as informações necessárias sobre a transação, e os clientes podem escolher se querem participar do Google Avaliações do Consumidor. Para que o comprador tenha essa opção, será necessário colocar o módulo em todas as páginas de confirmação dos pedidos. Se você estiver com problemas para integrar o módulo de permissão da pesquisa, acesse esta página para encontrar uma solução.
Neste artigo, você verá:
Com a permissão do usuário, o Google enviará para ele uma pesquisa após a data de entrega estimada do pedido. Veja mais informações em pesquisa do Google Avaliações do Consumidor.
A permissão da pesquisa funciona em computadores e dispositivos móveis. Adicione o snippet de código do módulo nos seus sites para essas duas plataformas.
Instruções de integração
Para incluir o módulo de permissão da pesquisa na página de confirmação do pedido, será necessário:
O código do módulo de ativação da pesquisa deve ser colocado na página de confirmação do pedido dos seus processos de finalização da compra. Todas as páginas de confirmação precisam usar HTTPS (não HTTP).
Os detalhes do pedido desse módulo precisam ser muito precisos, porque o módulo aciona a função de permissão da pesquisa do Google Avaliações do Consumidor (GCR, na sigla em inglês).
Caso seu processo de finalização de compra use um processador de terceiros, ele precisará redirecionar os clientes de volta para a página de confirmação no seu domínio.
Não oculte o módulo de ativação da pesquisa para o cliente do Google Avaliações do Consumidor com outro conteúdo.
Atualizar o DOCTYPE
Verifique se a página de confirmação usa o DOCTYPE HTML5:
<!DOCTYPE html>
Esse doctype precisa ser o primeiro item de linha no código HTML da página. Usar o DOCTYPE HTML5 garante que os navegadores da Web renderizem suas páginas no modo padrão, e não no modo quirks, O modo quirks é uma técnica usada por alguns navegadores da Web para manter a compatibilidade com páginas da Web projetadas para navegadores mais antigos, em vez de ser compatível apenas com os padrões W3C e IETF no modo padrão.
Adicionar o código de ativação
Para dar aos seus clientes a opção de enviar uma avaliação da experiência deles no seu site, adicione o módulo da função de permissão à página de confirmação do pedido.
Para adicionar o módulo da função de permissão da pesquisa à página de confirmação do pedido, siga estas etapas:
1. Cole o snippet de HTML abaixo na página de confirmação do pedido:
<!-- BEGIN GCR Opt-in Module Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"
async defer>
</script>
<script>
window.renderOptIn = function() {
window.gapi.load('surveyoptin', function() {
window.gapi.surveyoptin.render(
{
// REQUIRED
"merchant_id": "
MERCHANT_ID",
"order_id": "
ORDER_ID",
"email": "
CUSTOMER_EMAIL",
"delivery_country": "
COUNTRY_CODE",
"estimated_delivery_date": "
YYYY-MM-DD",
// OPTIONAL
"products":[{"gtin":"
GTIN1"}, {"gtin":"
GTIN2">}],
"opt_in_style": "
OPT_IN_STYLE"
});
});
}
</script>
<!-- END GCR Opt-in Module Code -->
Insira o código logo antes da tag de fechamento </BODY>. O código do módulo de pesquisa pode aparecer antes ou depois do código do selo caso você os coloque juntos. Nesse caso, a ordem é irrelevante.
2. Substitua as variáveis pelos valores dinâmicos específicos do seu site. A tabela a seguir descreve as configurações disponíveis:
Variável |
Obrigatório? |
Descrição |
MERCHANT_ID (ID do comerciante) |
Obrigatório |
Seu ID do Merchant Center. É possível descobrir esse valor no Google Merchant Center. |
ORDER_ID (Código do pedido) |
Obrigatório |
Um ID exclusivo para o pedido. |
CUSTOMER_EMAIL (E-mail do cliente) |
Obrigatório |
Endereço de e-mail do cliente no formato nome@domínio.com. |
COUNTRY_CODE (Código do país) |
Obrigatório |
O código do país de duas letras identifica o local em que o pedido do cliente será entregue. Esse valor precisa estar no formato ISO 3166-1 alpha-2. Não use "ZZ" para este campo. Por exemplo, "US". |
ESTIMATED_DELIVERY_DATE (Data de entrega estimada) |
Obrigatório |
A data de entrega estimada do pedido, em que YYYY é o ano, MM é o mês e DD é o dia. Por exemplo, "2016-09-13". |
GTIN1, GTIN2 (GTIN) |
Opcional |
|
OPT_IN_STYLE (Estilo da permissão) |
Opcional |
Especifica como a caixa de diálogo do módulo da função de permissão é exibida. Os valores possíveis são: "CENTER_DIALOG": exibido como uma caixa de diálogo no centro da visualização. "BOTTOM_RIGHT_DIALOG": exibido como uma caixa de diálogo no canto inferior direito da visualização. "BOTTOM_LEFT_DIALOG": exibido como uma caixa de diálogo no canto inferior esquerdo da visualização. "TOP_RIGHT_DIALOG": exibido como uma caixa de diálogo no canto superior direito da visualização. "TOP_LEFT_DIALOG": exibido como uma caixa de diálogo no canto superior esquerdo da visualização. "BOTTOM_TRAY": exibido na parte inferior da visualização. O valor padrão é "CENTER_DIALOG". |
Como alternativa, especifique o idioma do módulo de ativação colando o snippet de código abaixo na sua página da Web. Se você não adicionar um valor para o parâmetro lang
, o selo vai usar a configuração de navegador do usuário para escolher o idioma automaticamente.
<!-- BEGIN GCR Language Code -->
<script>
window.___gcfg = {
lang: '
LANGUAGE'
};
</script>
<!-- END GCR Language Code -->
Insira o código antes da tag de fechamento </BODY> na página. Quando colocado junto com o código de ativação, a ordem não importa.
Substitua LANGUAGE por um dos seguintes idiomas compatíveis para definir o valor do parâmetro lang
:
Código |
Nome do idioma |
af |
Africâner |
ar |
Árabe |
cs |
Tcheco |
da |
Dinamarquês |
de |
Alemão |
en |
Inglês |
en-AU |
Inglês (Austrália) |
en-GB |
Inglês (Reino Unido) |
en-US |
Inglês (EUA) |
es |
Espanhol |
es-419 |
Espanhol (América Latina) |
fil |
Filipino |
fr |
Francês |
ga |
Irlandês |
id |
Indonésio |
it |
Italiano |
ja |
Japonês |
ms |
Malaio |
nl |
Holandês |
no |
Norueguês |
pl |
Polonês |
pt-BR |
Português (Brasil) |
pt-PT |
Português |
ru |
Russo |
sv |
Sueco |
tr |
Turco |
zh-CN |
Chinês (simplificado) |
zh-TW |
Chinês (tradicional) |
Exemplo de código de ativação da pesquisa
Os valores das variáveis normalmente são substituídos na página de confirmação do pedido pelo código do servidor. O exemplo abaixo mostra como você pode implementar o código do módulo da de permissão com PHP:
<!-- BEGIN GCR Opt-in Module Code -->
<script src="https://apis.google.com/js/platform.js?onload=renderOptIn"
async defer>
</script>
<script>
window.renderOptIn = function() {
window.gapi.load('surveyoptin', function() {
window.gapi.surveyoptin.render(
{
"merchant_id": 42,
"order_id": "<?php echo $order_id ?>",
"email": "<?php echo $email_address ?>",
"delivery_country": "<?php echo $user_country ?>",
"estimated_delivery_date": "<?php echo $delivery_date ?>",
"products": [{"gtin":"<?php echo $gtin_1 ?>"}, {"gtin":"<?php echo $gtin_2 ?>"}],
"opt_in_style": "BOTTOM_LEFT_DIALOG"
});
});
}
</script>
<!-- END GCR Opt-in Module Code -->
<!-- BEGIN GCR Language Code -->
<script>
window.___gcfg = {
lang: 'en_US'
};
</script>
<!-- END GCR Language Code -->
Se o módulo não aparecer ou você receber mensagens de erro ao carregar a página, consulte a seção Solução de problemas.