Google Analytics para sites móveis

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:

  1. Faça o download do snippet do servidor para seu ambiente de servidor.
  2. Faça upload do snippet de código para seu servidor.
  3. 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("&", "&amp;", $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("&", "&amp;");
  }
%>

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("&", "&amp;");
  }
</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/&/&amp\;/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() . '" />';