As páginas AMP são veiculadas a partir de um domínio de cache de AMP diferente do domínio do seu site. Para acompanhar a jornada do usuário em um cache de AMP e nas páginas do seu site, utilize o AMP Linker, um recurso amp-analytics que associa sessões com o ID do cliente de AMP como identificador de usuário.
Os AMP Linkers adicionam links externos a partir de páginas de cache de AMP com um ID de cliente de AMP. As páginas com tags do Google Analytics recuperam o ID de cliente de AMP do parâmetro de consulta de URL e entram na sessão de usuário com o ID de cliente de AMP como identificador de usuário.
Este artigo descreve as etapas necessárias para configurar um AMP Linker com o Google Analytics.
Como o ID de cliente de AMP afeta seus dados
A sincronização dos IDs de cliente de AMP entre um cache de AMP e o domínio original do site resulta em métricas de usuário mais precisas, por exemplo, "duração da sessão", "taxa de rejeição" e "páginas por sessão". Para que o ID de cliente de AMP seja útil, os dados precisam ser coletados na mesma propriedade do Google Analytics.
Configurar o AMP Linker
Para configurar o AMP Linker com o Google Analytics, siga estas três etapas:
- Inclua tags nas suas páginas AMP.
- Inclua tags nas suas páginas não AMP.
- Configure exclusões de referências.
Etapa 1. Adicionar tags às suas páginas AMP para passar os parâmetros do AMP Linker.
Instale uma tag do Google Analytics usando a tag do Google (gtag.js) ou o Gerenciador de tags do Google. Siga as instruções abaixo de acordo com sua implementação:
Opção 1: tag do Google
Adicione a tag do Google para AMP padrão nas suas páginas de destino AMP. Veja o exemplo de snippet abaixo e faça as seguintes alterações:
Substitua MEASUREMENT_ID pelo ID de acompanhamento da propriedade do Google Analytics a que você gostaria de enviar dados.
Se preferir, caso as páginas AMP estejam hospedadas em um domínio de nível superior diferente dos links de saída para seu site ou as páginas AMP não estejam em um subdomínio conhecido (ou seja, não em www., amp., m.), inclua uma configuração do vinculador, conforme mostrado abaixo. Adicione o domínio em que a página está hospedada e os domínios dos links de saída.
<script type="application/json">
{
"vars": {
"gtag_id": "MEASUREMENT_ID",
"linker": {
"domains": ["example.com", "example2.com"]
}
,
"config": {
"MEASUREMENT_ID": {
"groups": "default"
}
}
}
}
</script>
</amp-analytics>
gtag_id, você pode especificar o ID de qualquer produto do Google, por exemplo, Google Ads ou Search Ads 360, que esteja usando nas suas AMPs, mas use apenas um ID de produto do Google no campo gtag_id.Opção 2: Gerenciador de tags do Google
Crie um contêiner de AMP no Gerenciador de tags do Google.
Adicione uma tag do Google Analytics ao seu contêiner AMP.
Adicione uma tag do Vinculador de conversões ao contêiner AMP e selecione "Ativar a vinculação entre domínios" e "Ativar a vinculação ao ID do cliente do Google Analytics". Se as páginas de destino AMP estiverem hospedadas no mesmo domínio de nível superior que os links externos para seu site, deixe o campo de domínios em branco.
Se preferir, caso suas páginas AMP estejam hospedadas em um domínio de nível superior diferente dos links de saída para seu site ou as páginas AMP não estejam em um subdomínio conhecido (ou seja, não em www., amp., m.), adicione o domínio de nível superior em que sua página AMP está hospedada, bem como domínios para links de saída como uma lista delimitada por vírgulas.
Use o snippet de código padrão do Gerenciador de tags na sua página AMP. Veja o exemplo abaixo e substitua GTM_CONTAINER_ID pelo ID do contêiner do Gerenciador de tags.
<!-- Google Tag Manager →
<amp-analytics config="https://www.googletagmanager.com/amp.json?id=< GTM_CONTAINER_ID>>m.url=SOURCE_URL" data-credentials="include">
</amp-analytics>
Etapa 2: Adicionar tags às suas páginas não AMP para ler os parâmetros do AMP Linker
Há várias maneiras de incluir tags nas páginas não AMP para ler os parâmetros do AMP Linker. Portanto, use as instruções referentes à sua configuração.
Opção 1: tag do Google
Inclua o snippet gtag.js nas suas páginas não AMP. Veja o exemplo de snippet abaixo:
- Substitua
MEASUREMENT_IDpelo ID de acompanhamento da propriedade do Google Analytics a que você gostaria de enviar dados. - Se preferir, caso as páginas AMP estejam hospedadas em um domínio de nível superior diferente dos links de saída para seu site ou as páginas AMP não estejam em um subdomínio conhecido (ou seja, não em www., amp., m.), inclua uma configuração do vinculador, conforme mostrado abaixo. Adicione o domínio em que a página está hospedada e os domínios dos links de saída.
<script async src="https://www.googletagmanager.com/gtag/js?id=MEASUREMENT_ID"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('set', 'linker', {
'domains': ['example.com', 'example2.com']
});
gtag('js', new Date());
gtag('config', 'MEASUREMENT_ID');
</script>
Opção 2: Gerenciador de tags do Google
No contêiner da Web do Gerenciador de tags do Google, verifique se a tag do Google Analytics foi adicionada.
Se as páginas AMP estiverem hospedadas em domínios de nível superior diferentes dos links de saída para seu site ou se as páginas AMP não estiverem em um subdomínio conhecido (ou seja, não em www, amp., m.), adicione a seguinte configuração: na tag do Google Analytics, adicione um campo "allowLinker" com o valor true usando as etapas abaixo:
- Abra a variável de configurações do Google Analytics que você quer editar e clique no cartão Configuração da variável.
- Vá para Mais configurações > Campos a serem definidos.
- Clique em + ADICIONAR CAMPO.
- Defina Nome do campo como allowLinker e Valor como true.
- Salve a nova configuração da variável.
- Repita as etapas anteriores para todas as variáveis de configuração do Google Analytics (se você estiver usando mais de uma variável no contêiner).
- Publique o contêiner.
Use o código padrão do Gerenciador de tags nas suas páginas não AMP.
Opção 3: analytics.js
Nas suas páginas não AMP, você pode usar o snippet de código Analytics.js padrão para ler os parâmetros do AMP Linker.
<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'GA_TRACKING_ID', 'auto');
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
Se preferir, caso as páginas AMP estejam hospedadas em um domínio de nível superior diferente dos links de saída para seu site ou as páginas AMP não estejam em um subdomínio conhecido (ou seja, não em www. amp., m.), adicione a configuração destacada abaixo, conforme descrito em Configuração de vários domínios na analytics.js:
<!-- Google Analytics -->
<script>
(function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
(i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
})(window,document,'script','https://www.google-analytics.com/analytics.js','ga');
ga('create', 'GA_TRACKING_ID', 'auto', {'allowLinker': true});
ga('require', 'linker');
ga('linker:autoLink', ['subdomain1.example.com', 'subdomain2.example.com','www.example2.com'] );
ga('send', 'pageview');
</script>
<!-- End Google Analytics -->
Etapa 3. Adicionar uma exclusão de referência ao Admin Console do Google Analytics
Quando o Google veicula conteúdos de AMP para os usuários, ele usa o cache de AMP. Para evitar que subdomínios AMP armazenados em cache interrompam sessões, adicione uma exclusão de referência para o domínio cdn.ampproject.org.
subdomain.example.com, adicione outra para subdomain-example-com.cdn.ampproject.org. Saiba mais sobre o formato de URL do cache de AMP.Verificação de configuração
Verifique se o ID de cliente de AMP do Google é correspondente entre as páginas AMP e não AMP.
Opção 1: verificar usando a ferramenta de teste da tag AMP
Use a ferramenta Teste de tag AMP e insira o URL de AMP a ser testado.
Observação: a ferramenta de teste da tag AMP é uma ferramenta de testes automatizados que simula um fluxo da página AMP veiculada pelo visualizador para um link para a próxima página. Essa ferramenta precisa ser usada como orientação e pode não fornecer todos os cenários de teste (por exemplo, se a página AMP tiver links para domínios ou subdomínios diferentes). Use as opções abaixo para as opções de testes manuais.
Opção 2: confirmar usando a extensão do Chrome do Assistente de tags do Google
- Faça o download e instale a extensão para o Chrome do Assistente de tags do Google.
- Insira uma consulta de pesquisa no google.com.br que retornará uma página AMP do seu site.
- Inicie os Registros do Assistente de tags.
- Atualize os resultados da pesquisa no navegador após o início do registro.
- Clique no resultado da pesquisa que leva à sua página AMP.
- Clique em um link que leva da página AMP para uma página não AMP.
- Interrompa os Registros do Assistente de tags.
- Verifique se há apenas uma sessão com IDs consistentes, como abaixo (isto é, o carregamento de página 2 não mostra o início da sessão).
Opção 3: verificar usando as Ferramentas para desenvolvedores do Chrome
- Abra o Google Chrome no modo de navegação anônima. Ative o emulador de dispositivos móveis nas Ferramentas para desenvolvedores do Chrome.
- Insira uma consulta de pesquisa no google.com.br que retorne uma página AMP para seu site e clique em um resultado referente à sua página AMP, que será veiculada pelo cache de AMP do Google e exibida no visualizador de AMP da Pesquisa Google.
- Observação: caso sua página ainda não esteja disponível nos resultados da pesquisa Google, você pode testar a unificação da sessão. Basta acessar a ferramenta Teste de AMP para visualizar os resultados e seguir as etapas abaixo, desde que a página possa ser indexada pelo Google.
- Encontre a solicitação de rede do Google Analytics para ver a página AMP: acesse a guia Rede nas Ferramentas para desenvolvedores do Chrome e insira collect no campo Filtro.
- Localize e selecione a solicitação de rede que leva a
www.google-analytics.com. Na guia "Cabeçalhos" da solicitação, localize o ID do cliente em "Parâmetros de string de consulta". Veja o parâmetro "cid". - Quando a página AMP é veiculada pelo visualizador de AMP, o formato do
cidé uma string base64 de 64 caracteres: - Clique em Limpar para limpar as solicitações da rede.
- Para verificar se você ativou suas páginas não AMP, confirme se o parâmetro de cid continua o mesmo ao navegar até uma página desse tipo. Basta clicar em qualquer link na página AMP que direcione a uma página não AMP veiculada a partir do seu domínio. Para encontrar o ID do cliente, filtre novamente a string "collect". Selecione qualquer solicitação de rede que acesse
www.google-analytics.com. Verifique se o valor do parâmetro de consulta cid corresponde ao valor anotado na Etapa 5.
Limitações
- A unificação de sessão pelo AMP Linker não acontecerá se um usuário novo fechar a página AMP sem navegar para a próxima página, já que a unificação de sessão funciona quando um link é adicionado.
