Importare statistiche da Google Analytics con PHP

Google Analytics, come probabilmente sapete, è un servizio gratuito di casa Google che ci permette di avere una visione completa del traffico sul nostro sito in maniera chiara e particolarmente precisa.

Con questo articolo vi spiegherò come poter utilizzare la libreria GAPI per poter importare dati e i risultati delle nostre ricerche direttamente sul nostro sito.

Immaginiamo di voler estrarre la classifica delle pagine più visualizzate nell’arco dell’ultimo mese in ordine decrescente.

La prima cosa da fare è collegarci al sito ufficiale per scaricare la libreria: GAPI Download.

A questo punto scriviamo il codice che ci permetterà di effettuare la ricerca rispettando i tre punti fondamentali:

• Connessione
• Interrogazione
• Ricezione ed elaborazione dei risultati 

 
<?php
// importo la classe
include('gapi-1/gapi.class.php');
gapi();
function gapi(){
// connessione
$ga = new gapi(nomeUtente,password);
$ga->requestAccountData();
 $id = '';
//per ogni risultato scrivi il profilo attivo sull'account
foreach($ga->getResults() as $result)
{
  $id = $result->getProfileId();
}
$ga->requestReportData($id,array('pageTitle'),array('pageViews'),array('-pageviews'),null,'2012-07-01', '2012-08-01');
$gaResults = $ga->getResults();
foreach($gaResults as $pagina) {
  $titolo_pagina = $pagina;
  $visite = $pagina->getPageViews();
echo $titolo_pagina." => ".$visite."<br />";
}
}
?>
 

Per utilizzare il codice basta inserire i propri dati, che saranno quelli che utilizzate per connettervi all’account di Google e passare alla funzione requestReportData() i parametri necessari per soddisfare la nostra ricerca. 

La funzione requestReportData() accetta i seguenti parametri:

 
requestReportData( $report_id,
                          $dimensions,
                          $metrics,
                          $sort_metric, // default null
                          $filter, // default null
                          $start_date, // default null
                          $end_date, // default null
                          $start_index, // default 1
                          $max_results); // default 30
 

 Per chiarire il significato tutte queste “parole” senza senso vi rimando alla tabella della documentazione ufficiale:

GAPIDocumentation - Google Analytics Report Request

I parametri, come potete vedere, sono numerosi e le possibili combinazioni ancora di più! La scelta giusta delle variabili ci permetterà quindi di ottenere i dati desiderati!

Qualche esempio..

Origine del traffico in ordine decrescente di visite:

 
$ga->requestReportData($id, array('source'), array('visits'),'-visits');
 

Origine del traffico per Stati in ordine decrescente di pagine visitate:

 
$ga->requestReportData($id, , array('country'), array('pageviews') ,'-pageViews');
 

Visite giornaliere ordinate per mese e giorno:

 
$ga->requestReportData($id, array('day','month'), array('visits'),array('month','day'));