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 contiver a marcação urchin.js
ou a sintaxe ga.js
tradicional, 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 atual e todas as personalizações feitas por você.
Para reduzir erros, recomendamos que você remova o snippet de código de acompanhamento existente do arquivo ou mecanismo de inclusão 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 usados.
-
Insira o snippet assíncrono
na parte inferior da seção
<head>
das suas páginas depois de qualquer outro script que sua página ou modelo possa usar.Uma das principais vantagens do snippet assíncrono é que é possível posicioná-lo na parte superior do documento HTML. Isso aumenta a probabilidade de o sensor de acompanhamento ser enviado antes de o usuário sair da página. Determinamos que, na maioria das páginas, o local ideal para o snippet assíncrono é a parte inferior da seção
<head>
, logo antes da tag</head>
de fechamento. -
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 (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 simples 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 seu HTML - Após o snippet de código de acompanhamento e todo o conteúdo da página (por exemplo, na parte inferior do corpo do HTML)
Se isso não for uma opção, você ainda poderá colocar o snippet assíncrono na parte inferior da página. Também é possível dividir o snippet para manter alguns dos benefícios do rastreamento assíncrono.
Acompanhamento básico de páginas
O acompanhamento básico de páginas é o melhor lugar para 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 de 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. É possível ajustar a duração das campanhas usando o método _setCampaignCookieTimeout()
.
Snippet assíncrono (recomendado)
_gaq.push(['_setAccount', 'UA-XXXXX-X']); _gaq.push(['_setCampaignCookieTimeout', 31536000000]); _gaq.push(['_trackPageview']);
Campos da campanha — Personalizados
O Google Analytics coletará automaticamente seus dados do Google Ads se você tiver vinculado sua conta do Google Ads à sua conta 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 campanhas" 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 rastrear o tráfego em vários domínios, você pode usar a função _setAllowLinker()
para acompanhar os cliques dos usuários entre dois domínios. Para detalhes sobre como configurar o 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
Você pode usar o método _linkByPost()
para transmitir dados do usuário de um domínio para outro quando o acompanhamento de vários domínios estiver ativado nos dois domínios. Para detalhes sobre como configurar o 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 e-commerce
O acompanhamento de e-commerce envolve chamar três métodos principais na sua configuração de acompanhamento. Consulte Acompanhamento de comércio eletrônico para 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
O uso do acompanhamento de eventos envolve fazer uma chamada de evento no local apropriado nas suas páginas, como em um manipulador 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 com o 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 manipulador de 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. Nestes exemplos,
mostramos 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']);
Fontes: mecanismos de pesquisa, palavras-chave, referenciadores
Por padrão, o Google Analytics identifica uma lista de sites como referências de mecanismos de pesquisa nos seus relatórios. Você pode usar esses métodos para alterar a lista do mecanismo 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 para 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 para todo acompanhamento. Você faria isso para limitar todo o rastreamento 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 autônomo do WebRTC e o Google Analytics. Para mais detalhes, consulte a seção Servidor do Urchin da referência API de acompanhamento.
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 que você cria
para rastrear cliques de usuários que não levam a páginas reais do seu site. Em geral,
recomendamos o uso de 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 adicionadas à sua contagem total de visualizações de página.
Snippet assíncrono
_gaq.push(['_trackPageview', '/downloads/pdfs/corporateBrief.pdf']);