Informações gerais
Todos os dados que você espera dos relatórios do Google Analytics agora estão disponíveis para a segmentação de telefones com base em WAP ou outros dispositivos móveis de baixo custo que não executam JavaScript. Basta colar nossos snippets de código do lado do servidor (disponíveis para PHP, JavaScript, ASP.NET e PERL) em cada página que você quer acompanhar. Depois de implementado, o Google Analytics cria o mesmo tipo de informação nos relatórios padrão do Analytics, incluindo informações sobre sessões e origens de tráfego.
Depois que o snippet do lado do servidor é implementado, o código específico do idioma gera um URL para uma tag de imagem que precisa ser colocada em cada página acompanhada. O URL da imagem será o mesmo em que o snippet do lado do servidor está hospedado. Quando o usuário acessa a página rastreada do dispositivo móvel, o navegador carrega a página, que, por sua vez, solicita a imagem criada pelo snippet acima. Quando o snippet do lado do servidor recebe a solicitação, ele dispara outra solicitação para enviar dados ao Google Analytics.
Vamos começar
Para começar a usar o snippet do lado do servidor do Google Analytics, você precisa:
- Faça o download do snippet do servidor para seu ambiente de servidor.
- Faça upload do snippet de código para seu servidor.
- Atualize as páginas no servidor que você quer acompanhar com o código específico do idioma
Fazer o download da biblioteca
O pacote a seguir contém snippets do lado do servidor e exemplos para todas as linguagens com suporte.
Pacote | Tamanho | Soma de verificação SHA1 |
---|---|---|
googleanalyticsformobile.zip | 35,7 KiB | 9102c9d8f9ddd3f53f7330d41b3b14b73a662646 |
Depois disso, faça o upload do snippet no idioma escolhido para o servidor da Web.
Atualize suas páginas da Web
Depois de fazer o upload do snippet do lado do servidor para seu servidor da Web, você poderá adicionar o código de acompanhamento a cada uma das suas páginas. Clique na guia para acessar as instruções específicas da linguagem de programação.
Observação: você precisa mudar o prefixo no seu ID da propriedade da Web de análise de UA- para MO- nos snippets do lado do servidor mostrados abaixo.
Por exemplo, se o ID da propriedade da Web for UA-12345-67
, use MO-12345-67
nos snippets do lado do servidor.
PHP
O snippet do lado do servidor para PHP requer PHP 5.
O pacote PHP do Google Analytics para dispositivos móveis inclui um arquivo chamado ga.php
que, quando carregado, grava uma pequena imagem na resposta. Para usá-la, você precisa copiar ga.php
para o projeto, de modo que possa ser acessado pelos outros scripts PHP. Os usuários não o acessarão diretamente, mas seus scripts PHP conterão uma tag HTML <img>
que faz referência a ga.php
. O código ga.php
, por sua vez, envia uma solicitação ao serviço do Google Analytics e retorna os dados da imagem, que são renderizados por HTML.
Um método de exemplo, googleAnalyticsGetImageUrl
, está incluído no pacote para ajudar a gerar o URL completo da imagem. Este é o script de exemplo:
<?php // Copyright 2009 Google Inc. All Rights Reserved. $GA_ACCOUNT = "ACCOUNT ID GOES HERE"; $GA_PIXEL = "/ga.php"; function googleAnalyticsGetImageUrl() { global $GA_ACCOUNT, $GA_PIXEL; $url = ""; $url .= $GA_PIXEL . "?"; $url .= "utmac=" . $GA_ACCOUNT; $url .= "&utmn=" . rand(0, 0x7fffffff); $referer = $_SERVER["HTTP_REFERER"]; $query = $_SERVER["QUERY_STRING"]; $path = $_SERVER["REQUEST_URI"]; if (empty($referer)) { $referer = "-"; } $url .= "&utmr=" . urlencode($referer); if (!empty($path)) { $url .= "&utmp=" . urlencode($path); } $url .= "&guid=ON"; return str_replace("&", "&", $url); } ?>
Agora, é só uma questão de chamar esse método e usar o URL resultante como o atributo src
de uma tag HTML <img>
. O método envia uma solicitação para ga.php
com os parâmetros de acompanhamento relevantes. O ga.php
envia esses parâmetros para o serviço do Google Analytics e retorna a imagem para renderizar:
<?php $googleAnalyticsImageUrl = googleAnalyticsGetImageUrl(); echo '<img src="' . $googleAnalyticsImageUrl . '" />'; ?>
JSP
O snippet do lado do servidor para JavaScript foi testado no Chácara 6.
O pacote de Japan do Google Analytics para dispositivos móveis inclui um arquivo chamado ga.jsp
que, quando carregado, grava uma pequena imagem na resposta. Para usá-la, você precisa copiar ga.jsp
para seu projeto e incluir um mapeamento em web.xml
ou de forma que ele possa ser acessado. Os usuários não o acessarão diretamente, mas suas próprias JavaScripts terão uma tag HTML <img>
que faz referência a ela. O código ga.jsp
, por sua vez, envia uma solicitação ao serviço do Google Analytics e retorna os dados da imagem, que são renderizados por HTML.
Um método de amostra, googleAnalyticsGetImageUrl
, está incluído no pacote de download
para ajudar a gerar o URL completo da imagem. Veja o exemplo de JavaScript:
<%@ page import="java.io.UnsupportedEncodingException, java.net.URLEncoder" %> <%! // Copyright 2009 Google Inc. All Rights Reserved. private static final String GA_ACCOUNT = "ACCOUNT ID GOES HERE"; private static final String GA_PIXEL = "/ga.jsp"; private String googleAnalyticsGetImageUrl( HttpServletRequest request) throws UnsupportedEncodingException { StringBuilder url = new StringBuilder(); url.append(GA_PIXEL + "?"); url.append("utmac=").append(GA_ACCOUNT); url.append("&utmn=").append(Integer.toString((int) (Math.random() * 0x7fffffff))); String referer = request.getHeader("referer"); String query = request.getQueryString(); String path = request.getRequestURI(); if (referer == null || "".equals(referer)) { referer = "-"; } url.append("&utmr=").append(URLEncoder.encode(referer, "UTF-8")); if (path != null) { if (query != null) { path += "?" + query; } url.append("&utmp=").append(URLEncoder.encode(path, "UTF-8")); } url.append("&guid=ON"); return url.toString().replace("&", "&"); } %>
Agora, é só uma questão de chamar esse método e usar o URL resultante como o atributo src
de uma tag HTML <img>
. O método envia uma solicitação para ga.jsp
com os parâmetros de acompanhamento relevantes. O ga.jsp
envia esses parâmetros para o serviço do Google Analytics e retorna a imagem para renderizar:
<% String googleAnalyticsImageUrl = googleAnalyticsGetImageUrl(request); %> <img src="<%= googleAnalyticsImageUrl %>" />
ASP.net
O snippet do lado do servidor para ASP.NET foi testado no IIS 6.0.
O pacote ASP.NET do Google Analytics para dispositivos móveis inclui um arquivo chamado ga.aspx
que, quando carregado, grava uma pequena imagem na resposta. Para usá-la, copie ga.aspx
no seu projeto para que ele possa ser acessado pelas outras ASPs. Os usuários não o acessarão diretamente, mas suas próprias ASPs terão uma tag HTML <img>
que faz referência a ga.aspx
. O código ga.aspx
, por sua vez, envia uma solicitação ao serviço do Google Analytics e retorna os dados da imagem, que são renderizados por HTML.
Um método de amostra, GoogleAnalyticsGetImageUrl
, está incluído no pacote de download para ajudar a gerar o URL completo da imagem. Veja um exemplo de ASP:
<%@ Page Language="C#" %> <script language="C#" runat="server"> // Copyright 2009 Google Inc. All Rights Reserved. private const string GaAccount = "ACCOUNT ID GOES HERE"; private const string GaPixel = "/ga.aspx"; private string GoogleAnalyticsGetImageUrl() { System.Text.StringBuilder url = new System.Text.StringBuilder(); url.Append(GaPixel + "?"); url.Append("utmac=").Append(GaAccount); Random RandomClass = new Random(); url.Append("&utmn=").Append(RandomClass.Next(0x7fffffff)); string referer = "-"; if (Request.UrlReferrer != null && "" != Request.UrlReferrer.ToString()) { referer = Request.UrlReferrer.ToString(); } url.Append("&utmr=").Append(HttpUtility.UrlEncode(referer)); if (HttpContext.Current.Request.Url != null) { url.Append("&utmp=").Append(HttpUtility.UrlEncode(Request.Url.PathAndQuery)); } url.Append("&guid=ON"); return url.ToString().Replace("&", "&"); } </script>
Agora, é só uma questão de chamar esse método e usar o URL resultante como o atributo src
de uma tag HTML <img>
. O método envia uma solicitação para ga.aspx
com os parâmetros de acompanhamento relevantes. O ga.aspx
envia esses parâmetros para o serviço do Google Analytics e retorna a imagem para renderizar:
<% string googleAnalyticsImageUrl = GoogleAnalyticsGetImageUrl(); %> <img src="<%= googleAnalyticsImageUrl %>" />
Perl
O snippet do lado do servidor para Perl requer Perl 5.10.
O pacote Perl do Google Analytics para dispositivos móveis inclui um arquivo chamado ga.pl
que, quando carregado, grava uma pequena imagem na resposta. Para usá-la, você precisa copiar ga.pl
para o projeto, de modo que ele possa ser acessado pelos outros scripts Perl. Os usuários não o acessarão diretamente, mas seus scripts Perl terão uma tag HTML <img>
que referencia ga.pl
. O código ga.pl
, por sua vez, envia uma solicitação ao serviço do Google Analytics e retorna os dados da imagem, que são renderizados por HTML.
Uma sub-rotina de exemplo, google_analytics_get_image_url
, está incluída no pacote de download
para ajudar a gerar o URL completo da imagem. Este é o script de exemplo:
# Copyright 2009 Google Inc. All Rights Reserved. use URI::Escape; use constant GA_ACCOUNT => 'ACCOUNT ID GOES HERE'; use constant GA_PIXEL => '/ga.pl'; sub google_analytics_get_image_url { my $url = ''; $url .= GA_PIXEL . '?'; $url .= 'utmac=' . GA_ACCOUNT; $url .= '&utmn=' . int(rand(0x7fffffff)); my $referer = $ENV{'HTTP_REFERER'}; my $query = $ENV{'QUERY_STRING'}; my $path = $ENV{'REQUEST_URI'}; if ($referer eq "") { $referer = '-'; } $url .= '&utmr=' . uri_escape($referer); $url .= '&utmp=' . uri_escape($path); $url .= '&guid=ON'; $url =~ s/&/&\;/g; $url; }
Agora, é só uma questão de chamar essa sub-rotina e usar o URL resultante como o atributo src
de uma tag HTML <img>
. A sub-rotina vai enviar uma solicitação para ga.pl
com os parâmetros de acompanhamento relevantes. O ga.pl
envia esses parâmetros para o serviço do Google Analytics e retorna a imagem para renderizar:
print '<img src="' . google_analytics_get_image_url() . '" />';