Nesse artigo irei demonstrar como fazer consultas no Google Analytics, de um determinado site, para ser usado em c??lculos estat??sticos afim de gerar gr??ficos semelhantes. Ou seja, irei demonstrar como fazer a consulta e retornar os dados. Os gr??ficos e exposi????o dos dados ficar?? ao seu crit??rio. Ao final poder?? ter algo assim:
Primeiramente e ??bvio, ?? preciso dos dados da conta Google como o e-mail e senha para autentica????o. Cada site cadastrado no Analytics tem um ID do Perfil e ele pode ser localizado na seguinte p??gina de Configura????es do Perfil. Atrav??s desse Id ?? que consultamos os dados de um determinado site.
Com esses dados em m??os, vamos ao entendimento da integra????o. O Google disponibilizou um framework que auxilia na consulta e retorno de dados em .NET e ela pode ser baixada no Google GData. Dentro dela cont??m v??rios bin??rios mas precisaremos apenas dos seguintes:
- Google.GData.Analytics.dll
- Google.GData.Client.dll
- Google.GData.Extensions.dll
Adicione-os ao seu projeto. Mas antes de come??ar a programar isso, vamos ao entendimento das consultas realizadas. No link http://code.google.com/intl/pt-BR/apis/analytics/docs/gdata/gdataExplorer.html tem um simulador que ser?? similar ?? consulta feita pela sua aplica????o. J?? no link http://code.google.com/intl/pt-BR/apis/analytics/docs/gdata/gdataReferenceDimensionsMetrics.html cont??m toda as especifica????es necess??rias.
Como n??o gosto de perder tempo e, para muitos pode ser um pouco confuso o seu entendimento logo de cara, vamos fazer uma abstra????o:
- ids: ?? o ID do Perfil conforme vimos anteriormente;
- dimensions: vamos “acatar” que seja os relacionamentos (linhas) (n??o ?? obrigat??rio);
- metrics: vamos “acatar” que seja o que deseja buscar (colunas);
- segment: especifica????o do tipo de consulta (n??o ?? obrigat??rio);
- filters: ?? o WHERE da consulta (n??o ?? obrigat??rio);
- sort: ordena????o (n??o ?? obrigat??rio);
- start-date: data de in??cio (formato yyyy-MM-dd);
- end-date: data final (formato yyyy-MM-dd);
- start-index: serve para paginar dados (como o MySQL usa o LIMIT);
- max-result: quantidade m??xima de registros retornados.
Essa ?? a explica????o mais entend??vel poss??vel e que posso passar para voc??s. Logo, antes de botar a m??o na massa, sugiro fazer v??rias simula????es e ver como ?? retornado os objetos. De acordo com a simula????o que fiz, por exemplo, e de acordo com a figura seria a seguinte busca:
“Me retorne todas as cidades, que visitaram meu blog, com suas respectivas quantidades de visitas no per??odo de 03/07/2011 a 17/07/2011 ordenada por cidade. S?? me traga os 50 primeiros registros.”
Ent??o, me seria retornado a seguinte “tabela”:
Ficou claro? Tranquilo, n??? A pior parte j?? passou. Agora, porqu?? escrevi “tabela”… Porque n??o ??! Lembra que abstra??mos para que seja isso. Sabendo de como a API trabalha ent??o bastemos implementar. Vamos l??! Pode-se criar uma classe ou incorporar na mesma p??gina o c??digo. Fica a seu crit??rio!
Adicione os seguintes namespaces:
using Google.Analytics;
using Google.GData.Analytics;
using Google.GData.Client;
using Google.GData.Extensions;
Tamb??m as vari??veis abaixo s??o necess??rias para a devida autentica????o e consulta nas quais descrevem:
// Vari??veis
string user; // Usu??rio da Conta Google Analytics
string pass; // Senha da Conta Google Analytics
string id_tabela; // ID do Perfil
// Inicializa????o
user = “email@gmail.com”;
pass = “senha”;
id_tabela = “ga:30897221”; // Tem que colocar a string “ga” na frete do ID do Perfil
Agora adicione os seguinte m??todos:
/// <summary>
/// Consulta o Analytics
/// </summary>
/// <param name=”query”></param>
private DataFeed ConsultaAnalytics(DataQuery query)
{
AnalyticsService asv = new AnalyticsService(“gaExportAPI_acctSample_v2.0”);
asv.setUserCredentials(user, pass);
String baseUrl = “https://www.google.com/analytics/feeds/data”;
query.Ids = id_tabela;
query.Uri = new Uri(baseUrl);
return asv.Query(query);
}
/// <summary>
/// Retorna o resultado da consulta
/// </summary>
/// <param name=”query”></param>
/// <returns></returns>
private DataTable RetornaTabela(DataQuery query)
{
DataTable resultado = new DataTable();
DataFeed feed = ConsultaAnalytics(query);
if (feed.Entries.Count > 0)
{
// Cria as colunas
DataEntry colunEntry = feed.Entries[0] as DataEntry;
foreach (Dimension colundimension in colunEntry.Dimensions)
resultado.Columns.Add(new DataColumn(colundimension.Name.Substring(3)));
foreach (Metric colunmetric in colunEntry.Metrics)
resultado.Columns.Add(new DataColumn(colunmetric.Name.Substring(3)));
// Insere os dados
foreach (DataEntry singleEntry in feed.Entries)
{
DataRow rw = resultado.NewRow();
foreach (Metric metric in singleEntry.Metrics)
rw[metric.Name.Substring(3)] = metric.Value;
foreach (Dimension dimension in singleEntry.Dimensions)
rw[dimension.Name.Substring(3)] = dimension.Value;
resultado.Rows.Add(rw);
}
}
return resultado;
}
??bvio que essas s??o apenas sugest??es de implementa????es e voc?? podem mudar o quanto achar melhor a depender de sua unidade de neg??cio. Agora vamos fazer aquela consulta:
// Dados da consulta
DataQuery q = new DataQuery();
q.Dimensions = “ga:city”;
q.Metrics = “ga:visits”;
q.GAStartDate = DateTime.Parse(“03/07/2011”).ToString(“yyyy-MM-dd”);
q.GAEndDate = DateTime.Parse(“17/07/2011”).ToString(“yyyy-MM-dd”);
q.Sort = “ga:city“;
q.NumberToRetrieve = 50;
// Resultado
DataTable resultado = RetornaTabela(q);
Pronto! Ir?? me retornar um DataTable com aquela tabela de dados. Basicamente todas aquelas informa????es que voc?? v?? no Analytics s??o vindas em formato tabela e que, posteriormente, s??o feitos tratamentos e c??lculos sobre eles. Como disse no in??cio do artigo, agora basta usar a tabela de dados conforme desejar…
Espero que tenham gostado depois de um tempo sem postar nada…