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 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:

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

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

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

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

Voltar ao início

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

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

Voltar ao início

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>

Voltar ao início

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

Voltar ao início

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> 

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

Voltar ao início

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

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

Voltar ao início

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

Voltar ao início

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

Voltar ao início