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
_cookiePathCopy(newPath)
_getLinkerUrl(targetUrl, useHash)
_link(targetUrl, useHash)
_linkByPost(formObject, useHash)
_setAllowHash(bool)
descontinuado_setAllowLinker(bool)
_setCookiePath(newCookiePath)
_setDomainName(newDomainName)
_storeGac(bool)
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()
.
_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.
_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()
_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.
<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.
<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.
_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.
_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
:
_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.
_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.
_gaq.push(['_storeGac', false]);