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, experimente a solução de problemas.
Confira os tópicos deste artigo:
Com a permissão do usuário, o Google envia para ele uma pesquisa após a data de entrega estimada do pedido. Para mais informações, leia a Pesquisa do Google Avaliações do Consumidor.
A função de 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 da função de permissão da pesquisa na página de confirmação do pedido, é necessário:
O código do módulo de função de permissã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 devem ser muito precisos porque o módulo aciona a função de permissão da pesquisa do Google Avaliações do Consumidor.
Caso seu processo de finalização de compra use um processador de terceiros, ele vai 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, faça o seguinte:
- 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. A ordem entre eles não importa.
- 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 no Merchant Center. Essa informação está no canto superior direito da sua conta. |
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" neste 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 | Valores numéricos de GTIN. |
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 de baixo 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 as configurações do 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 |
ml | 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 de permissão não aparecer ou você receber mensagens de erro ao carregar a página, consulte a solução de problemas.