Código de acompanhamento: domínios e diretórios

Esta referência descreve os métodos usados para personalizar como os relatórios do Google Analytics funcionam em vários domínios, hosts diferentes ou subdiretórios de um site.

Métodos de domínio/diretório do GATC

Detalhes dos métodos

_cookiePathCopy()

_cookiePathCopy(newPath)

Muda os caminhos de todos os cookies do GATC para o caminho recém-especificado. Use esse recurso para acompanhar o comportamento do usuário de uma estrutura de diretórios para outra no mesmo domínio.

Quando é chamada, essa função copia imediatamente todos os cookies para o novo caminho. Portanto, se o método _trackPageview() não tiver sido chamado, os valores para todos os cookies do Google Analytics existentes serão fornecidos. Por esse motivo, recomendamos que esse método seja chamado depois de _trackPageview(), bem como de outros métodos de configuração que possam afetar os valores de cookies ou de campanha que você queira transmitir, como _setCampaignCookieTimeout() ou _setReferrerOverride().

Snippet assíncrono (recomendado) 
_gaq.push(['_cookiePathCopy', '/newSubDirectory/']);

parâmetros

String   newPath Novo caminho para armazenar cookies GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Esse método funciona em conjunto com os métodos _setDomainName() e _setAllowLinker() para ativar o acompanhamento de usuários em vários domínios, especificamente para iframes e links que são abertos em uma nova janela. Esse método retorna uma string de todos os dados do cookie do GATC do link inicial, anexando-o ao parâmetro de URL. Ele pode ser transmitido para outro site ou iframe.

Snippet assíncrono (recomendado) 
  _gaq.push(function() {
    var pageTracker = _gat._getTrackerByName(); // Gets the default tracker.
    var linkerUrl = pageTracker._getLinkerUrl('http://www.my-example-iframecontent.com/');
  });

parâmetros

String   targetUrl URL do site de destino para onde os valores de cookie serão enviados.

Boolean   useHash Defina como "true" para transmitir variáveis do código de acompanhamento usando o separador de tag de âncora "#" em vez do "?" padrão? padrão.

retorna

String O URL do vinculador.

_link()

_link(targetUrl, useHash)

Este método funciona em conjunto com os métodos _setDomainName() e _setAllowLinker() para permitir o acompanhamento de usuários em vários domínios. O método _link() transmite os cookies do GATC do site para outro por meio de parâmetros de URL (HTTP GET). Ele também muda o document.location e redireciona o usuário para o novo URL.

Snippet assíncrono (recomendado) 
<a href="http://example.com/test.html"
onclick="_gaq.push(['_link', 'http://example.com/test.html']); return false;">click me</a>

parâmetros

String   targetUrl URL do site de destino para onde os valores de cookie serão enviados.

Boolean   useHash Defina como "true" para transmitir variáveis do código de acompanhamento usando o separador de tag de âncora "#" em vez do "?" padrão? padrão.

_linkByPost()

_linkByPost(formObject, useHash)

Este método funciona em conjunto com os métodos _setDomainName() e _setAllowLinker() para permitir o acompanhamento de usuários em vários domínios. O método _linkByPost() transmite os cookies GATC do formulário de referência para outro site em uma string anexada ao valor de ação do formulário (HTTP POST). Esse método normalmente é usado para acompanhar o comportamento do usuário de um site para um site de carrinho de compras de terceiros. Ele também pode ser usado para enviar dados de cookies a outros domínios em pop-ups ou iframes.

Snippet assíncrono (recomendado) 
    <form action="http://www.shoppingcartsite.com/myService/formProcessor.php"
    name="f" method="post" onsubmit="_gaq.push(['_linkByPost', this]);">
...
</form>

Além disso, _setAllowLinker() precisa ser definido como true na página da Web de destino para que a vinculação funcione.

parâmetros

HTMLFormElement   formObject Objeto de formulário que encapsula a solicitação POST.

Boolean   useHash Defina como "true" para transmitir variáveis do código de acompanhamento usando o separador de tag de âncora "#" em vez do "?" padrão? padrão.

_setAllowHash()

_setAllowHash(bool)

Define a sinalização para permitir hash do domínio. Por padrão, esse valor é definido como true. A funcionalidade de hash de domínio no Google Analytics cria um valor de hash do seu domínio e usa esse número para verificar a integridade do cookie para os visitantes. Se você tiver vários subdomínios, como example1.example.com e example2.example.com, e quiser acompanhar o comportamento dos usuários em ambos, desative o hash de domínio para que a verificação de integridade do cookie não rejeite um cookie do usuário de um domínio para outro. Além disso, é possível desativar esse recurso para otimizar o desempenho do rastreamento por página.

parâmetros

Boolean   true ou false O valor padrão é true. Se o parâmetro for definido como true, o hash de domínio será ativado. Caso contrário, esse recurso será desativado.

_setAllowLinker()

_setAllowLinker(bool)

Define a sinalização de funcionalidade do vinculador como parte da ativação do acompanhamento de usuários em vários domínios. Por padrão, esse método é definido como false, e a vinculação está desativada. Consulte também os métodos _link(), _linkByPost() e _setDomainName() para ativar o acompanhamento de vários domínios. Use o método _setAllowLinker no site de destino para que ele use os dados de cookies no parâmetro de URL, em vez da lógica de sessão padrão.

Snippet assíncrono (recomendado) 
_gaq.push(['_setAllowLinker', true]);

parâmetros

Boolean  true ou false O valor padrão é false. Se esse parâmetro for definido como true, o vinculador será ativado. Caso contrário, a vinculação de domínios será desativada.

_setCookiePath()

_setCookiePath(newCookiePath)

Define o novo caminho do cookie para seu site. Por padrão, o Google Analytics define o caminho do cookie no nível raiz (/). Na maioria das situações, essa é a opção apropriada e funciona corretamente com o código de acompanhamento instalado no seu site, blog ou diretório da Web corporativo. No entanto, nos casos em que o acesso do usuário é restrito a apenas um subdiretório de um domínio, esse método pode resolver problemas de acompanhamento definindo um subdiretório como o caminho padrão para todo o acompanhamento.

Normalmente, isso é feito se seus dados não estão sendo rastreados e você se inscreveu em um serviço de blog e só tem acesso ao subdiretório definido, ou se você está em uma rede corporativa ou universitária e só tem acesso ao seu diretório principal.

Snippet assíncrono (recomendado) 
_gaq.push(['_setCookiePath', '/myBlogDirectory']);

parâmetros

String   newCookiePath Novo caminho do cookie a ser definido.

_setDomainName()

_setDomainName(newDomainName)

Define o nome de domínio dos cookies GATC. Há três modos para esse método: ("auto" | "none" | [domain]). Por padrão, o método é definido como auto, que tenta resolver o nome de domínio com base na propriedade document.domain no DOM.

Especificar um domínio

Consulte o Guia de acompanhamento de vários domínios para ver vários exemplos que ilustram quando e como especificar um domínio com esse método. O exemplo a seguir ilustra como definir o nome de domínio como example.com:

Snippet assíncrono (recomendado) 
_gaq.push(['_setDomainName', 'example.com']);

Como isolar domínios de nível superior

Definir esse método como none garante que os cookies em um determinado domínio não sejam acessíveis por nenhum subdomínio.

Snippet assíncrono (recomendado) 
_gaq.push(['_setDomainName', 'none']);

parâmetros

String   newDomainName Novo nome de domínio padrão a ser definido.

_storeGac(bool)

Determina se o cookie do GAC deve ser criado ou não. Por padrão, o cookie do GAC é gravado pelo script, e você não precisa fazer nada para gravá-lo. Você pode desativar a configuração desse cookie usando o comando abaixo.

Snippet assíncrono (recomendado) 
_gaq.push(['_storeGac', false]);