Registro de alterações do acompanhamento da Web do Google Analytics (ga.js)

Periodicamente, atualizamos o código de acompanhamento JavaScript do Google Analytics (ga.js) para oferecer novos recursos e corrigir erros identificados nas versões anteriores.

Esta página documenta todas as mudanças feitas no código de acompanhamento da biblioteca ga.js. Consulte regularmente esta lista para não perder os novos comunicados. Você também pode se inscrever para receber as mudanças pelos feeds listados na seção Inscrever-se nos registros de alterações relacionados abaixo.

Você e seus usuários talvez não vejam o código de acompanhamento ga.js atualizado imediatamente pelos seguintes motivos:

  • As alterações são lançadas de forma incremental ao longo de vários dias na infraestrutura de data center global do Google.
  • Os usuários do seu site talvez tenham versões antigas do nosso JavaScript armazenadas em cache nos navegadores.

Inscrever-se nos registros de alterações relacionados

Todos os registros de alterações da API Google Analytics
–
Fazer inscrição rss

Inclui todas as APIs de coleta, configuração e relatórios.

Todos os registros de alterações dos SDKs e das APIs de coleta
–
Fazer inscrição rss

Inclui acompanhamento da Web (ga.js e analytics.js), SDK do Android e iOS e Measurement Protocol.

Registro de alterações de acompanhamento da Web (ga.js)
–
Fazer inscrição rss
  • Os hits que não contêm um ID de acompanhamento válido agora são descartados.
  • A pesquisa segura do Yahoo agora é classificada corretamente como uma origem orgânica.
  • Agora é possível usar APIs de pré-renderização sem prefixo. A pré-renderização funciona no IE11 e no Chrome.
  • Esta é uma versão de manutenção.

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • Agora é possível especificar moedas locais usando _set (por exemplo, gaq.push(['_set', 'currencyCode', 'EUR'])).

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • A taxa de amostragem de velocidade do site máxima permitida (_setSiteSpeedSampleRate) aumentou de 10% para 100%.
  • Agora, quando você usa o método _setAccount, os espaços adicionais no início e no fim são removidos.

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • Atualizamos a lista de mecanismos de pesquisa orgânica que são detectados por padrão. Foram adicionadas as opções "startsiden.no", "rakuten.co.jp", "biglobe.ne.jp" e "goo.ne.jp". Removemos "search" e incluímos "conduit.com", "babylon.com", "search-results.com", "avg.com", "comcast.net" e "incredimail.com", que eram atribuídos conjuntamente como "search".

Fizemos as seguintes alterações na versão mais recente do código de acompanhamento:

  • O limite do tamanho da variável personalizada aumentou de 64 para 128 caracteres. Além disso, o tamanho é verificado antes da codificação do URL.
  • Também aumentamos a limitação de taxa para hits de evento. Agora é possível enviar 10 hits, com 1 hit adicional por segundo (antes, você só podia enviar 1 hit a cada 5 segundos). No entanto, o limite de 500 hits por sessão não foi alterado.
  • Os cookies __utmv agora são criados com um separador de variáveis diferente (acentos circunflexos, em vez de vírgulas) para serem usados com RFCs. Isso corrigirá alguns dos problemas relacionados à codificação de cookies.

Alterações na coleta de dados da velocidade do site:

  • Os dados de velocidade do site agora são coletados automaticamente para todas as propriedades da Web a uma taxa de amostragem de 1%. A função _trackPageLoadTime, que antes era necessária para coletar essas informações, foi descontinuada.
  • Já é possível ajustar a taxa de amostragem padrão com a nova função _setSiteSpeedSampleRate.
  • Se um caminho virtual for usado na chamada _trackPageview, ele também vai passar a ser associado aos dados de velocidade do site coletados nessa página.

Novidades desta versão:

  • É possível marcar os eventos como "Sem interações" definindo o novo parâmetro opt_noninteraction do método _trackEvent() como true. Essa opção indica que os hits do evento em questão não afetarão a taxa de rejeição. Para saber mais, consulte a referência da ga.js.

O bug a seguir foi corrigido nesta versão:

  • Resolvemos um problema em que a propagação do parâmetro de URL gclid do Google AdWords em vinculações de sites internos aumentava o número de visitas pagas.

Esta versão corrigiu um bug que causava dois eventos: um número artificialmente maior de visitas e/ou uma redução no número de novos visitantes de alguns sites. O primeiro afetava, em sua maioria, sites com tráfego orgânico e comportamentos específicos do usuário. O segundo evento acontecia apenas em sites que usavam uma configuração incompatível de acompanhamento com vários rastreadores.

Alterações nos cálculos da sessão:

  • Uma campanha por sessão: se uma nova campanha for lançada durante uma sessão, o script de acompanhamento vai iniciar automaticamente outra sessão. Uma nova campanha será acionada quando houver alterações em qualquer um destes campos: "ID da campanha", "Nome", "Origem", "Mídia", "Termo", "Conteúdo" ou "GCLID".
  • O script de acompanhamento deixará de iniciar uma nova sessão caso o usuário feche o navegador.

Mudanças no acompanhamento de vários domínios:

  • Não é mais preciso chamar _setAllowHash(false) ao configurar o acompanhamento de vários domínios. As páginas que já chamam _setAllowHash(false) vão continuar funcionando, mas essa ação deixará de ser necessária ao criar um novo site.
  • Agora, o script de acompanhamento vai tentar corrigir os parâmetros do vinculador que foram corrompidos por redirecionadores HTTP e navegadores. Cerca de 85% dos valores do vinculador que são descartados atualmente devido a mudanças de codificação feitas por redirecionadores e navegadores vão passar a ser restaurados e aceitos pelo script.

Novidades desta versão:

  • O código de acompanhamento passou a adiar os hits de páginas pré-renderizadas até que elas sejam vistas pelo usuário. Se uma página dessas não for visualizada, nenhum hit será enviado. Esse recurso só está disponível para sites que usam o script de acompanhamento assíncrono. Saiba mais sobre a pré-renderização no blog da Central do webmaster do Google.

Esta versão inclui várias correções de bugs e refatorações, além de um novo recurso:

  • Agora é possível usar o acompanhamento social (_trackSocial).

Os bugs a seguir foram corrigidos nesta versão:

  • Resolvemos um bug no acompanhamento de vários domínios que causava a codificação incorreta dos dados da campanha.
  • Foi corrigido um bug no acompanhamento de vários domínios que fazia os cookies carregarem a partir do URL mais de uma vez, gerando cookies incorretos.
  • Também corrigimos um bug nas variáveis personalizadas que fazia com que alguns valores ficassem codificados nos relatórios.

Esta é uma versão de manutenção regular, incluindo correções de bugs e refatorações. Não houve alterações nos recursos ou nas APIs públicas.

Novidades desta versão:

  • Agora é possível usar o POST:

    • Já é possível enviar beacons de acompanhamento muito maiores com o código de acompanhamento. Os beacons costumavam ser transmitidos por solicitações HTTP GET, que só conseguem usar 2.048 caracteres em alguns navegadores e proxies. As solicitações que ultrapassavam esse limite eram descartadas, e os dados nunca chegavam ao Google Analytics. A partir desta versão, as solicitações que incluírem mais caracteres serão enviadas pelo HTTP POST, que não tem essa restrição. O código de acompanhamento passou a aceitar até 8.192 caracteres.

Os bugs a seguir foram corrigidos nesta versão:

  • Corrigimos um bug que impedia o funcionamento correto de _addIgnoredOrganic e _addIgnoredRef na primeira visita a um site.
  • Foi corrigido um problema em que o código de acompanhamento era executado em vários iframes.

Esta é uma versão de manutenção regular, incluindo correções de bugs e refatorações. Não houve alterações nos recursos ou nas APIs públicas.

Esta versão contém correções de bugs e a limpeza da API.

  • Correções de bugs:

    • Corrigimos o bug de acompanhamento de eventos. Para chamar _trackEvent, não é mais necessário chamar _initData ou _trackPageview primeiro.
    • Atualizamos o snippet assíncrono para que ele possa ser colocado no cabeçalho de qualquer página sem causar problemas no IE 6 e 7. Consulte o guia de acompanhamento assíncrono para conhecer o novo snippet. Essa atualização foi feita em 22 de março de 2010.
    • A sintaxe assíncrona foi ampliada para oferecer suporte à chamada de métodos no objeto _gat.

  • As APIs de inicialização do rastreador foram atualizadas de acordo com a sintaxe assíncrona. Além disso, as funções antigas foram desativadas.

    • Adicionamos a função _gat._createTracker(opt_account, opt_name), que permite que os objetos de acompanhamento sejam nomeados e recuperados depois de acordo com o nome. Use essa função em vez de _gat._getTracker(account).
    • Adicionamos _gat._getTrackerByName(name), que recupera o rastreador com o nome em questão.
    • Adicionamos tracker._getName(), que mostra o nome informado ao rastreador quando ele foi criado.
    • Removemos _gaq._createAsyncTracker(account, opt_name). Use _gat._createTracker.
    • Descontinuamos _gaq._getAsyncTracker(name). Use _gat._getTrackerByName.

  • Consulte a Referência do rastreador para ver detalhes sobre essas mudanças na API.

Esta versão inclui atualizações na lista de mecanismos de pesquisa padrão e novas funções para controlar o tempo limite dos cookies. Além disso, o snippet assíncrono do GA foi lançado e diminui o impacto da latência da ga.js na página.

  • Fizemos algumas atualizações na lista de mecanismos de pesquisa padrão.

    • Foram adicionados os mecanismos Naver, Eniro e Daum.
    • As opções Looksmart, Gigablast, Club-internet, Netsprint, Intera, Nostrum e Ilse foram removidas da lista.

  • Adicionamos funções para controlar o tempo limite de todos os cookies armazenados. As funções relacionadas foram descontinuadas. Consulte a documentação da API JS para ver mais detalhes.

    • _setVisitorCookieTimeout(cookieTimeoutMillis) substitui a função _setCookiePersistence.
    • _setSessionCookieTimeout(cookieTimeoutMillis) substitui a função _setSessionTimeout.
    • _setCampaignCookieTimeout(cookieTimeoutMillis) substitui a função _setCookieTimeout.

  • O snippet assíncrono do GA foi lançado. Confira a documentação para saber como usar esse snippet.

  • A função _setVar foi descontinuada. O recurso de variáveis personalizadas substitui _setVar. Veja a documentação relacionada para mais detalhes.

Novidades desta versão:

  • Adicionamos uma nova função para recuperar variáveis personalizadas no nível do visitante. Consulte a documentação da função para ver mais detalhes.

    • _getVisitorCustomVar(index)

  • Em vez de aguardar window.onload, o conteúdo de cobertura do site passará a ser carregado assim que a ga.js for executada.

Novidades desta versão:

  • Adicionamos um parâmetro booleano opcional à função _addOrganic para especificar se novas origens orgânicas devem ser adicionadas no início ou no fim da lista relacionada. Veja a documentação para mais detalhes.

    • _addOrganic(newOrganicEngine, newOrganicKeyword, opt_prepend)

Esta é uma versão de manutenção regular, incluindo melhorias de performance e refatorações. Não houve alterações nos recursos ou nas APIs públicas.

Nesta versão, corrigimos vários bugs e fizemos melhorias de performance:

  • Codificação apropriada para os termos de pesquisas orgânicas, informações sobre o caminho da página da Web para (utmp) e valores definidos pelo usuário utilizados com o recurso do vinculador (ou seja, as funções _link e _linkByPost).
  • O mecanismo Rambler foi adicionado à lista de pesquisas orgânicas.
  • Foi corrigida a análise da pesquisa orgânica no mecanismo http://kvasir.no.
  • Incluímos novos mecanismos de pesquisa orgânica definidos pelo usuário no topo da lista.
  • A função _trackEvent(action, label, value) descontinuada foi removida e substituída por _trackEvent(category, action, label, value).
  • Os URLs de referenciadores agora são armazenados com distinção entre maiúsculas e minúsculas. Por exemplo, www.domain.com/PaGe.HtMl será registrado com informações de letras maiúsculas e minúsculas.
  • Adicionamos um limite de 1.200 caracteres ao tamanho do token do GASO.
  • Adição de uma nova função para permitir a substituição de tempos limite padrão para cookies: _setCookiePersistence(timeout)