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

Esta referência descreve os métodos que você usa para personalizar a forma como os relatórios do Google Analytics funcionam nos domínios, em hosts diferentes ou nos subdiretórios de um site.

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

Detalhes do método

_cookiePathCopy()

_cookiePathCopy(newPath)

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

Quando essa função é chamada, ela copia imediatamente os cookies para o novo caminho. Portanto, se o método _trackPageview() não tiver sido chamado, os valores de 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 outros métodos de configuração que podem afetar os valores de cookies ou da campanha que você quer transmitir, como _setCampaignCookieTimeout() ou _setReferrerOverride().

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

parâmetros

String   newPath Novo caminho para armazenar cookies do GATC.

_getLinkerUrl()

_getLinkerUrl(targetUrl, useHash)

Esse método funciona com os métodos _setDomainName() e _setAllowLinker() para permitir o rastreamento de usuários em vários domínios especificamente para iframes e links abertos em uma nova janela. Esse método retorna uma string de todos os dados de cookies do GATC do link inicial anexando-os ao parâmetro de URL. Depois, 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 enviar valores de cookies.

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

retorna.

String O URL do vinculador.

_link(targetUrl, useHash)

Esse método funciona 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 deste site para outro usando parâmetros de URL (HTTP GET). Isso 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 enviar valores de cookies.

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


_linkByPost()

_linkByPost(formObject, useHash)

Esse método funciona com os métodos _setDomainName() e _setAllowLinker() para ativar o acompanhamento de usuários em vários domínios. O método _linkByPost() transmite os cookies do GATC do formulário de referência para outro site em uma string anexada ao valor de ação do formulário (HTTP POST). Normalmente, esse método é usado ao rastrear o comportamento do usuário de um site para um site de carrinho de compras de terceiros, mas também pode ser usado para enviar dados de cookies para 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, para que a vinculação funcione, _setAllowLinker() precisa ser definido como true na página da Web de destino.

parâmetros

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

Boolean   useHash Defina como"true"para transmitir variáveis de código de acompanhamento usando o separador de tag â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. O recurso de hash de domínio no Google Analytics cria um valor de hash com base no 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 do usuário nesses dois subdomínios, desative o hash de domínio para que a verificação de integridade de cookies não rejeite um cookie do usuário que chega de um domínio para outro. Além disso, é possível desativar esse recurso para otimizar o desempenho do acompanhamento por página.

parâmetros

Boolean   true ou false O valor padrão é true. Se esse 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 é 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, em alguns 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 rastreamento definindo um subdiretório como o caminho padrão para todo o acompanhamento.

Normalmente, esse status é usado quando seus dados não estão sendo acompanhados e você é inscrito em um serviço de blog e só tem acesso ao subdiretório definido ou se está em uma rede corporativa ou universitária e tem acesso apenas ao seu diretório inicial.

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

Como 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. Veja no exemplo a seguir 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 possam ser acessados 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(Booleano)

Determina se o cookie do GAC deve ser criado ou não. Por padrão, o cookie do GAC é escrito pelo script e você não precisa fazer nada para escrever o cookie. É possível desativar a configuração desse cookie usando o comando abaixo.

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