Clase php para utilizar la API Google Analytics. Programación en Castellano.

Categorías destacadas

Artículo

Inicio Artículo Internet PHP

¡votar!

Clase php para utilizar la API Google Analytics

Hace unos meses, Google abrió su servicio de Google Analytics para los usuarios, con el objetivo de que estos pudieran integrar los resultados en su propia aplicaciones.

Para poder utilizar esta API de forma sencilla, desde Askaboutphp, nos presentan una clase que se encarga de todo este trabajo. Solo debemos de pasarle los parámetros de nuestro informe y la clase nos devolverá los datos de Google Analytics.

Vamos a ver como funciona.

Lo primero que debemos de tener, claramente, es una cuenta en Google Analytics y los datos de acceso a esa cuenta. Una vez que tengamos eso, lo que necesitamos es la clase que vamos a utilizar, y que la podemos descargar desde este enlace.

Para acceder a la API necesitamos básicamente 2 pasos. Primero autenticarnos contra Google utilizando nuestras credenciales. Después puedes utilizar tu código de acceso a la tu lista de páginas webs y obtener los datos que tu quieras.

Un ejemplo de uso es el siguiente:

<?php
// include the Google Analytics PHP class
include "googleanalytics.class.php";
try {
// create an instance of the GoogleAnalytics class using your own Google {email} and {password}
$ga = new GoogleAnalytics('{email}','{password}');
// set the Google Analytics profile you want to access - format is 'ga:123456';
$ga->setProfile('{GA Profile ID}');
// set the date range we want for the report - format is YYYY-MM-DD
$ga->setDateRange('2009-04-01','2009-04-07');
// get the report for date and country filtered by Australia, showing pageviews and visits
$report = $ga->getReport(
array('dimensions'=>urlencode('ga:date,ga:country'),
'metrics'=>urlencode('ga:pageviews,ga:visits'),
'filters'=>urlencode('ga:country=@Australia'),
'sort'=>'-ga:pageviews'
)
);
//print out the $report array
print_r($report);
} catch (Exception $e) { 
print 'Error: ' . $e->getMessage(); 
}
?>

Lo primero que hacemos en el código es crear una instancia de la clase. Después utilizamos el método setProfile donde le indicaremo el id de la web de la que queremos obtener los datos. Este dato lo podemos obtener de la url, una vez que entramos en el sitio que queremos ver los datos.

Si nos fijamos en la imagen, aparece algo como id=xxxxxxx, pues ese número es el que debemos de utilizar, pero lo introduciremos con el formato “ga:xxxxxxx”.

La clase también dispone del método getWebsiteProfiles(), que lo que nos devolverá será una matriz con todas nuestras webs que controlemos mediante Google Analytics y sus correspondientes números de identificación.

Con la función setDateRange, le estamos indicando desde que fecha y hasta que fecha queremos que nos muestre los datos.

Para obtener los datos, solo debemos de hacer la llamada del método getReport(), donde le indicamos un array con los parámetros que queremos recuperar, así como los posibles filtros como puede ser un determinado país. Lo que nos devuelve, es un array similar al que se muestra más abajo.

Array
(
[20090401~~Australia] => Array
(
[ga:pageviews] => 6
[ga:visits] => 3
)
[20090402~~Australia] => Array
(
[ga:pageviews] => 4
[ga:visits] => 3
)
[20090407~~Australia] => Array
(
[ga:pageviews] => 4
[ga:visits] => 4
)
[20090403~~Australia] => Array
(
[ga:pageviews] => 3
[ga:visits] => 3
)
[20090405~~Australia] => Array
(
[ga:pageviews] => 3
[ga:visits] => 3
)
[20090406~~Australia] => Array
(
[ga:pageviews] => 3
[ga:visits] => 3
)
[20090404~~Australia] => Array
(
[ga:pageviews] => 2
[ga:visits] => 2
)
)

Para poder utilizar esta función, es necesario tener activo la función cURL de PHP.

Algunos ejemplos de obtención de datos pueden ser los siguientes:

/ what browsers visitors to your using?
$report = $ga->getReport(
array('dimensions'=>urlencode('ga:browser'),
'metrics'=>urlencode('ga:visits'),
'sort'=>'-ga:visits'
)
);
// which are your top landing pages and how long they spent on the page?
$report = $ga->getReport(
array('dimensions'=>urlencode('ga:landingPagePath,ga:pageTitle'),
'metrics'=>urlencode('ga:entrances,ga:timeOnPage'),
'sort'=>'-ga:entrances'
)
);
// which are your top internal search keywords by pageviews?
$report = $ga->getReport(
array('dimensions'=>urlencode('ga:searchKeyword'),
'metrics'=>urlencode('ga:pageview'),
'sort'=>'-ga:pageviews'
)
);

Vía: askaboutphp