Este documento fornece uma visão geral da biblioteca de coleta de dados do Analytics.js.
Fragmento Javascript
Para habilitar o Google Analytics em seu site, você deve adicionar um fragmento JavaScript antes da etiqueta </head> Página. Esta é uma parte do fragmento:
(function(i,s,o,g,r,a,m){i=r;i=i||function(){(i.q=i.q||).push(arguments)},i.l=1*new Date();a=s.createElement(o),m=s.getElementsByTagName(o);a.async=1;a.src=g;m.parentNode.insertBefore(a,m)})(window,document,'script','//www.google-analytics.com/analytics.js','ga');
Quando o fragmento é executado, primeiro cria uma nova função global chamada . Em seguida, a carga de fragmento assíncronamente a biblioteca analtics.js na página.
A função global é o modo principal de interagir com a biblioteca de análise .JS A função aceita uma sequência de parâmetros, onde o primeiro representa um comando do Google Analytics. Por exemplo, no fragmento padrão:
ga('create', 'UA-XXXX-Y', 'auto'); // Creates a tracker.ga('send', 'pageview'); // Sends a pageview.
A primeira linha chama o comando create e, o segundo, send
Embora o código JavaScript carregue a biblioteca do Analytics.js de forma assíncrona, o foi projetado para ser usado antes que a biblioteca seja carregada. Quando você começar a executar os comandos pela primeira vez, cada um é adicionado a uma fila. Quando a biblioteca terminar de carregar, todos os comandos da fila e os novos comandos são executados imediatamente. Desta forma, os programadores podem ignorar a natureza assíncrona do Google Analytics e concentrar-se no uso da função .
Alterar o nome do objeto global
Em alguns casos, é possível que um objeto na página já esteja usando o nome da variável . Para evitar que o objeto seja cancelado, você pode alterar o nome da função , por exemplo, para . Para isso, você só precisa substituir o parâmetro no fragmento anterior:
(function(i,s,o,g,r,a,m){i=r;i=i||function(){(i.q=i.q||).push(arguments)},i.l=1*new Date();a=s.createElement(o),m=s.getElementsByTagName(o);a.async=1;a.src=g;m.parentNode.insertBefore(a,m)})(window,document,'script','//www.google-analytics.com/analytics.js','__gaTracker');
depois, você pode Use __gaTracker em vez de para chamar os comandos:
__gaTracker('create', 'UA-XXXX-Y', 'auto');__gaTracker('send', 'pageview');
Referência de fragmento JavaScript
Na referência a seguir, o fragmento de javascript básico é mostrado, aos comentários e espaços em branco foram adicionados:
<!-- Google Analytics --><script>/** * Creates a temporary global ga object and loads analy tics.js. * Paramenters o, a, and m are all used internally. They could have been declared using 'var', * instead they are declared as parameters to save 4 bytes ('var '). * * @param {Window} i The global context object. * @param {Document} s The DOM document object. * @param {string} o Must be 'script'. * @param {string} g URL of the analytics.js script. Inherits protocol from page. * @param {string} r Global name of analytics object. Defaults to 'ga'. * @param {DOMElement?} a Async script tag. * @param {DOMElement?} m First script tag in document. */(function(i, s, o, g, r, a, m){ i = r; // Acts as a pointer to support renaming. // Creates an initial ga() function. The queued commands will be executed once analytics.js loads. i = i || function() { (i.q = i.q || ).push(arguments) }, // Sets the time (as an integer) this tag was executed. Used for timing hits. i.l = 1 * new Date(); // Insert the script tag asynchronously. Inserts above current tag to prevent blocking in // addition to using the async attribute. a = s.createElement(o), m = s.getElementsByTagName(o); a.async = 1; a.src = g; m.parentNode.insertBefore(a, m)})(window, document, 'script', '//www.google-analytics.com/analytics.js', 'ga');ga('create', 'UA-XXXX-Y', 'auto'); // Creates the tracker with default parameters.ga('send', 'pageview'); // Sends a pageview hit.</script><!-- End Google Analytics -->
Fragmento assíncrono alternativo
Embora o fragmento Canonical Analytics.js descrito acima garante que o script será cobrado e executado de forma assíncrona em todos os navegadores, tem a desvantagem de não permitir que os navegadores modernos façam uma carga prévia do script .
O fragmento alternativo a seguir adiciona compatibilidade da carga anterior, que fornece um pequeno pulso de desempenho nos navegadores modernos, mas Ele pode ser deteriorado na carga e execução síncrona no IE9 e nos navegadores para dispositivos móveis anteriores, que não reconhecem o atributo async. Sugerimos que você use este fragmento se seus visitantes usarem principalmente navegadores modernos para acessar seu site.
<!-- Google Analytics --><script async src='//www.google-analytics.com/analytics.js'></script><script>window.ga=window.ga||function(){(ga.q=ga.q||).push(arguments)};ga.l=+new Date;ga('create', 'UA-XXXX-Y', 'auto');ga('send', 'pageview');</script><!-- End Google Analytics -->
Criar objetos de rastreamento
para enviar dados Para o Google Analytics, você deve criar um objeto de acompanhamento. Cada um desses objetos pode enviar dados para uma única propriedade da Web do Google Analytics. Para criar um objeto de rastreamento, o fragmento padrão usa o seguinte código:
onde o primeiro parâmetro da função é o comando create e o segundo é o ID da propriedade da Web à qual os dados serão enviados.
Personalizar objetos de rastreamento
A personalização do objeto de rastreamento deve ser realizada quando é inicialmente criada, passando para a função Um objeto de configuração como o último parâmetro. Por exemplo, para cancelar algumas das opções de configuração do cookie, é usado:
ga('create', 'UA-12345-6', { 'cookieDomain': 'foo.example.com', 'cookieName': 'myNewName', 'cookieExpires': 20000});
No exemplo anterior, o domínio, nome e expiração de cookie de nome e hora foram modificados Usando o objeto de configuração opcional.
Verifique a seção apenas da referência de campo de comando de criação de documentos para obter informações completas sobre todos os campos que podem ser configurados no comando CREATE.
Testing no localhost
Em alguns casos, você pode tentar analtics.js de um servidor da Web que é executado em localhost. Para configurar cookies de análise.JS, você deve desativar o domínio de cookies padrão por:
ga('create', 'UA-XXXX-Y', { 'cookieDomain': 'none'});
Enviar dados
Uma vez que um objeto de rastreamento foi criado e associado Com uma propriedade da Web, você pode usar o comando send para enviar dados para essa propriedade da Web. Os dados enviados para o Google Analytics serão chamados hit e a biblioteca do Analytics.js permitem enviar vários tipos de dados especificando um tipo de hit (hitType). Ao usar o comando , você também deve especificar o valor de dos dados que você deseja enviar.
Por exemplo, para enviar um vídeo Vista Vista, ele é usado:
ga('send', 'pageview');
Desta forma, os dados são enviados para o URL padrão ao Google Analytics.
Nome do campo Objeto
Em alguns casos, você pode cancelar vários valores que são enviados como exibição de página. A biblioteca do Analytics.js permite que você envie um objeto Nome de campo como o último parâmetro do comando send. Isso é útil, pois permite definir muitas propriedades adicionais da página, por exemplo, seu título:
ga('send', 'pageview', { 'page': '/my-new-page', 'title': 'My New Page Title'});
Verifique a referência de campo dos campos para obter Informações completas sobre todas as maneiras pelas quais um objeto de rastreamento pode ser configurado.
Configure o retorno de chamada do hit
Em alguns casos, por exemplo, ao rastrear os links de saída, você pode saber quando o objeto de rastreamento de enviar os dados acabou. Desta forma, você pode enviar um usuário para o seu destino somente após o clique se comunicar ao Google Analytics. Para resolver essa situação, o comando permite especificar uma função hitCallback No objeto de nome do campo que será executado como Analytics. JS terminou de enviar os dados. Em seguida, mostramos como configurar a função hitCallback:
ga('send', 'pageview', { 'page': '/my-new-page', 'hitCallback': function() { alert('analytics.js done sending data'); }});
Neste exemplo, o objeto do campo Nome Defina o parâmetro page e função hitCallback. Depois que o objeto de rastreamento terminar de enviar os dados, uma caixa de alerta será exibida para o usuário.
Configurar os parâmetros em vários comandos Enviar
Em alguns casos, é recomendado parâmetro e que o valor é mantido em vários comandos send. Por exemplo, se você tiver uma página da Web, você deseja acompanhar uma exibição de página e dois eventos. Se você gostaria de cancelar o caminho de cada hit para um, você pode definir a nova rota em cada comando send ou use o método set Da seguinte forma:
ga('set', 'page', '/my-custom-page');ga('send', 'pageview');ga('send', 'event', 'image1', 'clicked');ga('send', 'event', 'image2', 'clicked');
Quando este código é executado, a página substituída /my-custom-page será enviada para todos os três Enviar comandos.
enviar hits useBeacon
enviar hits com navigator.sendBeacon, configure o parâmetro useBeacon como true. O método navigator.sendBeacon garante que os dados sejam transmitidos mesmo se o usuário deixar sua página ou fechar o navegador antes que a solicitação seja concluída. Isso é muito útil nos casos em que você deseja rastrear um evento antes de um usuário sair do seu site, sem atrasar a navegação.
ga('send', 'event', 'click', 'download-me', {useBeacon: true});
funções de transmissão
Às vezes, o código é executado apenas após a biblioteca do Analytics.js foi carregada. Para fazer isso, você pode enviar uma função como um parâmetro para a função
quando terminar de carregar A biblioteca, o usuário verá uma caixa de alerta.
obter parâmetros
com o analytics.js, você pode recuperar qualquer um dos valores que foram configurados no objeto de rastreamento por Meios do comando get. Como o objeto de rastreamento é criado apenas quando a biblioteca foi carregada, você deve obter parâmetros de uma função enviada.
ga(function(tracker) { var defaultPage = tracker.get('page');});
Neste exemplo, os EUA funcionam um Parâmetro chamado tracker. Quando a carga da biblioteca termina, a função é executada e o valor de tracker será o objeto de rastreamento padrão que foi criado como resultado do primeiro comando create. Em seguida, o objeto tracker é usado para obter o valor da página padrão.
Aplicar SSL (HTTPS)
“Por padrão, o Google Analytics será ajustado para o protocolo da página do host ao enviar as solicitações de saída.Para forçar o Google Analytics sempre enviar dados via SSL, mesmo a partir de páginas não seguras (HTTP), configure o campo ForenceL como true:
ga('create', 'UA-XXXX-Y', 'auto');ga('set', 'forceSSL', true); // Send all data using SSL, even from insecure (HTTP) pages.ga('send', 'pageview');
Trabalhe com vários objetos de rastreamento
Em alguns casos, é aconselhável enviar os dados para várias propriedades da Web de uma única página. Isso é útil para sites que têm vários proprietários que supervisionam certas seções de um site; Cada proprietário pode ver sua propriedade da web.
Para resolver esse problema, você deve criar um objeto de acompanhamento para cada propriedade da Web que você deseja enviar dados:
ga('create', 'UA-XXXX-Y', 'auto');ga('create', 'UA-12345-6', 'auto', {'name': 'newTracker'}); // New tracker.
Quando executar, dois objetos de rastreamento serão criados. O primeiro será o padrão e não terá um nome. O segundo será chamado newTracker
Para enviar uma visualização de página com os dois objetos de rastreamento, você deve definir o nome do objeto de rastreamento para o comando, seguido por um ponto. Por exemplo:
ga('send', 'pageview');ga('newTracker.send', 'pageview'); // Send page view for new tracker.
Uma página de exibição será enviada para o objeto de rastreamento padrão e o novo.
para acessar o rastreamento objeto por nome de uma função, use o método :
ga(function() { var newTracker = ga.getByName('newTracker');});
para obter uma matriz de todos os objetos de Rastreamento que foram configurados, use o método getAll:
ga(function() { var allTrackers = ga.getAll();});
alocação de link aprimorada
Com a atribuição de link aprimorada, a precisão do relatório analítico é aumentada pela diferenciação automática de vários links para o mesmo URL de única página com os IDs de item de link.
para ativar a atribuição de link aprimorada:
- permite a atribuição aprimorada do link na interface do usuário da administração da conta do Google Analytics.
- Atualize o código de cada página para carregar o plug-in Atribuição do link aprimorado, Como mostrado neste exemplo:
ga('create', 'UA-XXXX-Y', 'auto');ga('require', 'linkid'); // Load the plug-in. Note: this call will block until the plug-in is loaded.ga('send', 'pageview');
Personalize a atribuição aprimorada do link
O plug-in da atribuição do link melhorou distingue entre os links para o mesmo URL usando os IDs de elemento de um link ou um elemento principal, bem como um cookie. Você pode personalizar até que ponto você vai procurar o plugin no ID DOM um elemento, bem como o comportamento deste cookie, fornecendo as opções de configuração ao carregar o plug-in:
ga('create', 'UA-XXXX-Y', 'auto');ga('require', 'linkid', { 'cookieName': '_ela', // Cookie name. _gali by default. 'duration': 45, // Cookie duration. 30 seconds by default. 'levels': 5}); // Max DOM levels from link to look for element ID. 3 by default.ga('send', 'pageview');
Converta IPs em anônimo
Em alguns casos, talvez seja necessário se tornar um endereço IP anônimo do hit (Solicitação HTTP) que é enviado para o Google Analytics. Você pode converter em endereços IP anônimos de todos os hits enviados de uma página (a duração do objeto de rastreamento) usando o comando set e configurações de campo anonymizeIp como true
ga('set', 'anonymizeIp', true);
Para converter o endereço IP de um hit individual Anônimo, você pode configurar o campo anonymizeIp no objeto de configuração opcional do dito hit:
ga('send', 'pageview', { 'anonymizeIp': true});
para mais informações sobre a operação do Conversão IP em Anônimo, consulte o artigo converter IPs em anônimo no Google Analytics no centro de ajuda.
Desqualificação do usuário
Em alguns casos, você pode ser necessário desativar o Google Analytics Código de rastreamento em uma página sem ter que excluir o fragmento JavaScript. Por exemplo, você pode fazê-lo se a política de privacidade do seu site incluir a possibilidade de que um usuário desativa o rastreamento do Google Analytics.
A biblioteca do Analytics.js inclui uma propriedade de janela que, quando configurada como true, desativa o envio de dados do Analytics.js para o Google Analytics. Quando o Google Analytics tenta configurar um cookie ou retornar dados para servidores do Google Analytics, verifique se esta propriedade foi configurada como true. Em caso afirmativo, ele terá o mesmo efeito que o usuário tenha instalado o plug-in desabilitando para os navegadores do Google Analytics.
Para desabilitar o rastreamento, configurar a seguinte propriedade da janela como true
window = true;
No que o valor UA-XXXX-Y corresponde ao ID da propriedade da Web na qual você deseja desativar o rastreamento .
Esta propriedade da janela deve ser configurada antes de ligar para o código de rastreamento. Esta propriedade deve ser configurada em cada página onde você deseja desativar o rastreamento do Google Analytics. Se a propriedade não estiver configurada ou tiver sido configurada como falsa, o rastreamento funcionará da maneira usual.
Exemplo
Em seguida, um exemplo simples do código que você pode usar é exibido para oferecer aos usuários a funcionalidade desativada.
primeiro, ele adiciona um novo link HTML Para o site para executar a lógica desabilitante:
<a href="javascript:gaOptout()">Click here to opt-out of Google Analytics</a>
Adicione o seguinte fragmento de código antes do fragmento de código do Analytics.js. Não se esqueça de substituir o valor UA-XXXX-Y de gaProperty pela propriedade usada no site. É o mesmo valor que é passado para o comando create.
Quando um usuário clica no link Desativando HTML, a função . Um cookie será configurado com uma longa duração e a coleta de dados do Analytics.js será desativada. Quando um usuário retorna a este site, com o script anterior, ele será verificado se o cookie de desqualificação tiver sido configurado. Se sim, a coleta de dados do Analytics.js também será desativada.
Depuração
Você pode ativar a versão de depuração do Via DIV ID = “B4895048EE”>
só deve ser usado temporariamente ou durante o desenvolvimento, desde o analytics_debug.js é maior e atrasar os hits para o Google-analytics.com.
Depuração de acompanhamento
com a depuração, informações mais detalhadas serão enviadas para o console. Para ativar este tipo de depuração, use https://www.google-analytics.com/analytics_debug.js e esta linha de código antes do fragmento:
window.ga_debug = {trace: true};