Google Analytics para sites móveis

Visão geral

Os mesmos dados que você espera dos relatórios do Google Analytics agora estão disponíveis para segmentação de telefones com base em WAP ou outros dispositivos móveis de baixo custo que não executam JavaScript. Cole os 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 de sessão e origem de tráfego.

Depois que o snippet 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 um usuário acessa a página acompanhada do dispositivo móvel, o navegador para dispositivos móveis carrega a página, que por sua vez faz uma solicitação para 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.

Como 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 no 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 exemplos e snippets do lado do servidor para todas as linguagens compatíveis.

Pacote Tamanho Soma de verificação SHA1
googleanalyticsformobile.zip 35,7 KiB 9102c9d8f9ddd3f53f7330d41b3b14b73a662646

Após o download, faça upload do snippet no idioma de sua escolha para seu 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 conferir as instruções específicas da linguagem de programação.

Observação: você precisa alterar o prefixo no seu ID da propriedade da Web do Google Analytics de UA- para MO- nos snippets do lado do servidor fornecidos 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á-lo, copie ga.php no seu projeto para que ele possa ser acessado pelos outros scripts PHP. Seus usuários não o acessarão diretamente, mas seus próprios 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 via HTML.

Um método de amostra, googleAnalyticsGetImageUrl, está incluído no pacote para ajudar você a gerar o URL completo da imagem. Aqui está 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, é apenas uma questão de chamar esse método e usar o URL resultante como o atributo src de uma tag HTML <img>. Esse 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 Redis foi testado no local local.

O pacote de GPT do Google Analytics para dispositivos móveis inclui um arquivo chamado ga.jsp que, quando carregado, grava uma pequena imagem na resposta. Para usá-lo, copie ga.jsp para o projeto e inclua um mapeamento em web.xml ou de outra forma que possa ser acessado. Seus 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 via HTML.

Um método de amostra, googleAnalyticsGetImageUrl, está incluído no pacote de download para ajudar a gerar o URL completo da imagem. Este é um 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, é apenas uma questão de chamar esse método e usar o URL resultante como o atributo src de uma tag HTML <img>. Esse 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. Seus usuários não o acessarão diretamente, mas suas próprias ASPs conterã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 via HTML.

Um método de amostra, GoogleAnalyticsGetImageUrl, está incluído no pacote de download para ajudar a gerar o URL completo da imagem. Confira o 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, é apenas uma questão de chamar esse método e usar o URL resultante como o atributo src de uma tag HTML <img>. Esse 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á-lo, você precisa copiar ga.pl para seu projeto, de modo que possa ser acessado por seus outros scripts Perl. Seus usuários não o acessarão diretamente, mas seus próprios scripts Perl conterão uma tag HTML <img> que faz referência a 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 via HTML.

Uma sub-rotina de amostra, google_analytics_get_image_url, está incluída no pacote de download para ajudar você a gerar o URL completo da imagem. Aqui está 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, é apenas 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() . '" />';