Este documento mostra ilustrações do código de acompanhamento para diversas personalizações comuns de acompanhamento.
Se o snippet de acompanhamento do Google Analytics tiver a marcação urchin.js
ou a sintaxe tradicional ga.js
, use este guia para migrar o acompanhamento para o snippet assíncrono aprimorado.
Migração para acompanhamento assíncrono
Para converter suas páginas a fim de usar o snippet assíncrono:
-
Remova o snippet de código de acompanhamento existente e todas as personalizações que você fez.
Para reduzir os erros, recomendamos que você remova o snippet de código de acompanhamento existente do arquivo de inclusão ou do mecanismo que o injeta nas suas páginas da Web. Você pode colar seu snippet de código de acompanhamento existente em um arquivo de texto para acompanhar os métodos personalizados que utiliza.
-
Insira o snippet assíncrono
na parte de baixo da seção
<head>
das suas páginas, depois de todos os outros scripts que a página ou o modelo possam usar.Uma das principais vantagens do snippet assíncrono é a possibilidade de posicioná-lo na parte superior do documento HTML. Isso aumenta a probabilidade de o beacon de acompanhamento ser enviado antes de o usuário sair da página. Identificamos que, na maioria das páginas, o local ideal para o snippet assíncrono é na parte de baixo da seção
<head>
, logo antes da tag de fechamento</head>
. -
Modifique o método
_setAccount
com seu ID da propriedade da Web.
Para mais informações sobre IDs de propriedade da Web, consulte a seção Propriedade da Web no documento Contas e vistas da propriedade (perfis).
- Adicione as personalizações de volta usando a sintaxe assíncrona. Use as personalizações descritas no restante deste guia. Consulte o Guia de uso do acompanhamento assíncrono para informações detalhadas sobre o código de acompanhamento assíncrono.
Observação:para garantir a operação mais otimizada do snippet assíncrono em relação a outros scripts, recomendamos colocar outros scripts no site de uma destas maneiras:
- Antes do snippet de código de acompanhamento na seção
<head>
do HTML. - Depois do snippet do código de acompanhamento e de todo o conteúdo da página (por exemplo, na parte inferior do corpo do HTML)
Se isso não for possível, ainda será possível colocar o snippet assíncrono na parte inferior da página. Também é possível dividir o snippet para manter algumas das vantagens do acompanhamento assíncrono.
Acompanhamento básico de páginas
O acompanhamento básico de páginas é a melhor maneira de se familiarizar com a sintaxe assíncrona. Esses exemplos configuram o objeto de acompanhamento com a conta correta e chamam o método de acompanhamento da página.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_trackPageview']);
Detecção de configurações do navegador
Estes exemplos mostram personalizações de configurações do navegador, como a desativação da detecção de Flash, da detecção de nome/versão do navegador, etc.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setClientInfo', false]); _gaq.push(['_setAllowHash', false]); _gaq.push(['_setDetectFlash', false]); _gaq.push(['_setDetectTitle', false]); _gaq.push(['_trackPageview']);
Duração da campanha
Por padrão, a duração de uma campanha do Google Ads é definida como seis meses. Use o método _setCampaignCookieTimeout()
para ajustar a duração das campanhas.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setCampaignCookieTimeout', 31536000000]); _gaq.push(['_trackPageview']);
Campos de campanha — personalizados
O Google Analytics coletará automaticamente seus dados do Google Ads se você tiver vinculado suas contas do Google Ads e do Analytics. Para acompanhar links de palavras-chave de outras origens de publicidade ou de campanhas de e-mail/origens semelhantes, você pode criar campos de campanha personalizados usando os métodos a seguir. Para mais detalhes, consulte "Acompanhamento de campanha" no guia Origens de tráfego.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setCampNameKey', 'ga_campaign']); // name _gaq.push(['_setCampMediumKey', 'ga_medium']); // medium _gaq.push(['_setCampSourceKey', 'ga_source']); // source _gaq.push(['_setCampTermKey', 'ga_term']); // term/keyword _gaq.push(['_setCampContentKey', 'ga_content']); // content _gaq.push(['_setCampNOKey', 'ga_nooverride']); // don't override _gaq.push(['_trackPageview']);
Acompanhamento de campanha: desativado
O Google Analytics ativa o acompanhamento de campanhas automaticamente, mas você pode desativá-lo usando o método _setCampaignTrack()
.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setCampaignTrack', false]); // Turn off campaign tracking _gaq.push(['_trackPageview']);
Vinculação de vários domínios
Para acompanhar o tráfego entre domínios, use a função _setAllowLinker()
para acompanhar os cliques de usuários entre dois domínios. Para detalhes sobre a configuração do acompanhamento de vários domínios, consulte Acompanhamento de vários domínios.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setDomainName', 'none']); _gaq.push(['_setAllowLinker', true]); _gaq.push(['_trackPageview']); ... <a href="http://example.com/test.html" onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>
Dados do formulários de vários domínios
Use o método _linkByPost()
para transmitir dados de usuários de um domínio para outro quando o acompanhamento de vários domínios estiver ativado nos dois domínios. Para detalhes sobre a configuração do acompanhamento de vários domínios, consulte Acompanhamento de vários domínios.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setDomainName', 'none']); _gaq.push(['_setAllowLinker', true]); _gaq.push(['_trackPageview']); ... <form name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);"> ... </form>
Acompanhamento de comércio eletrônico
O Acompanhamento de comércio eletrônico envolve chamar três métodos principais na sua configuração de acompanhamento. Consulte Acompanhamento de comércio eletrônico para mais detalhes.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_trackPageview']); _gaq.push(['_addTrans', '1234', // order ID - required 'Mountain View', // affiliation or store name '11.99', // total - required '1.29', // tax '5', // shipping 'San Jose', // city 'California', // state or province 'USA' // country ]); _gaq.push(['_addItem', '1234', // order ID - required 'DD44', // SKU/code 'T-Shirt', // product name 'Green Medium', // category or variation '11.99', // unit price - required '1' // quantity - required ]); _gaq.push(['_trackTrans']);
Acompanhamento de eventos
Para usar o acompanhamento de eventos, é necessário realizar uma chamada de evento no local apropriado das suas páginas, como um gerenciador onclick
. Para mais informações sobre o acompanhamento de eventos, consulte o Guia de acompanhamento de eventos. Observação: o acompanhamento de eventos não está disponível no código de acompanhamento urchin.js.
Snippet assíncrono (recomendado)
Esta seção apresenta duas maneiras de configurar o acompanhamento usando sintaxe assíncrona. Com o acompanhamento de eventos, o gerenciador onclick
usa exatamente a mesma sintaxe.
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_trackPageview']); ... <a onclick="_gaq.push(['_trackEvent', 'category', 'action', 'opt_label', opt_value]);">click me</a>
Tempo limite da sessão
Por padrão, o tempo limite das sessões de usuário é atingido após trinta minutos de inatividade em seu site. Esses exemplos
mostram como isso pode ser modificado usando o método _setSessionCookieTimeout()
.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setSessionCookieTimeout', 3600000]); _gaq.push(['_trackPageview']);
Origens: mecanismos de pesquisa, palavras-chave, referenciadores
Por padrão, o Google Analytics identifica uma lista de sites como referências do mecanismo de pesquisa nos seus relatórios. Use estes métodos para mudar a lista de mecanismos de pesquisa. Para mais informações, consulte "Mecanismos de pesquisa" no guia Origens de tráfego. Também é possível configurar o Google Analytics para ignorar referências de determinados domínios ou tratar pesquisas de palavras-chave específicas como tráfego direto.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_addIgnoredOrganic', 'ignore']); _gaq.push(['_addIgnoredRef', 'urchin.com']); _gaq.push(['_addOrganic', 'new_search_engine', 'q']); _gaq.push(['_trackPageview']);
Acompanhamento limitado a um subdiretório
Use o método _setCookiePath()
para definir um subdiretório como o caminho padrão de todos os acompanhamentos. Faça isso para confinar todos os acompanhamentos a um subdiretório de um site.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setCookiePath', '/path/of/cookie/']); _gaq.push(['_trackPageview']);
Utilização de um servidor local
Use estes métodos se você estiver acompanhando seu site com o software OnHub independente e o Google Analytics. Para mais detalhes, consulte a seção Servidor do Urchin da referência da API de rastreamento.
Snippet assíncrono
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setLocalRemoteServerMode']); _gaq.push(['_trackPageview']);
Page views virtuais
Use o método _trackPageview()
com um URL fabricado por você para rastrear cliques de usuários que não levam a páginas reais do seu site. Em geral, recomendamos o uso do acompanhamento de eventos para acompanhar downloads, links externos, PDFs ou tipos semelhantes de interações do usuário. Isso ocorre porque as exibições virtuais de página serão somadas à contagem total de visualizações de página.
Snippet assíncrono
_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);