Comparações de sintaxe

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

Como prática recomendada, copie e salve as personalizações existentes do código de acompanhamento em um arquivo de texto (não um documento de um processador de texto). Com uma cópia de backup, você garante a migração de todas as personalizações do seu site.

Para converter suas páginas a fim de usar o snippet assíncrono:

  1. 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.

  2. 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>.

  3. 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).

  4. 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']);

Voltar ao início

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']);

Voltar ao início

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']);

Voltar ao início

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']);

Voltar ao início

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']);

Voltar ao início

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>

Voltar ao início

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>

Voltar ao início

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']);

Voltar ao início

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>

Voltar ao início

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']);

Voltar ao início

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']);

Voltar ao início

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']);

Voltar ao início

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']);

Voltar ao início

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']);

Voltar ao início