En el post anterior veíamos como conseguir tener acceso a los datos de Google Analytics vía API. Hemos aprendido a crear un proyecto en la consola de desarrolladores y nos han proporcionado unas claves, un email y un archivo que nos van a permitir acceder a los datos.
Lo que ahora necesitamos es una forma concreta de hacer las consultas. Para conseguirlo vamos a tirar de una librería php, que no es ni mas ni menos que una serie de archivos que nos vamos a descargar y nos van a proveer de las funciones necesarias para:
- Configurar el acceso a nuestros datos para no tener que introducir login y password cada vez que hagamos una petición y
- Funciones que nos van a permitir realizar las consultas necesarias.
Ésta librería realmente sirve para acceder a todas las APIS de Google, aunque la vamos a utilizar sólo para acceder a Analytics ( de momento).
Una vez descargada la librería, lo que tienes que hacer es subirla a tu servidor ( si no sabes como hacerlo o dónde ponerlo te paso un tutorial). No olvides también subir el archivo p12 que te descargaste desde la consola de desarrolladores de Google.
Intenta subirlo todo de una forma ordenada, al final de la serie de post de «crea tu dashboard» tendras un zip descargable con los archivos y la estructura ya montada, pero si quieres ir montándolo por tu cuenta mas vale que sigas un pequeño orden.
Conviene, para tener cambios posteriores controlados, hacernos u fichero con las constantes que vamos a utilizar. En otras palabras vamos a definir unas constantes para evitar problemas posteriores. Construye un archivo con el siguiente texto:
<?php
// definimos las constantes
define(«NOMBRE_APP», «XXXXXX»);//nombre que pusiste en APIs console
define(«ID», «XXXXXX»);// id que nos ha dado APIS console
define(«EMAIL», «XXXXXX»);//Email que nos ha dado APIS console
define(«FICHEROP_12», «XXXXXX»);// ubicación del fichero descargado
define(«CUENTA_GA», XXXXXX); // cuenta GA que utilizamos para acceder
?>
Ten cuidado, la cuenta_GA se consigue de la siguiente forma:
- Ve al panel de administración de GA.
- Elige una «vista», recuerda, ni cuenta ni propiedad «VISTA»
- y en «VER Configuración» encontrarás el número correspondiente.
- Ten en cuenta que es un NUMERO, no va entre comillas
Guarda el archivo y súbelo al servidor. Recuerda dónde los subes, porque luego deberá aparecer en un «include» en todos tus archivos.
Con un poco de orden ya establecido vamos con la siguiente fase en formato de archivo php. Ésta vez vamos a dejar preparado el código que nos da acceso a los datos, para poder hacer, posteriormente, las consultas necesarias. Presta atención, porque también es un archivo que tendrás que incluir («include») en los archivos de consulta. Vamos a ello,
<?php
//debes poner la ruta correcta para los siguientes archivos.dependerá de dónde decidas colocarlos.
require_once ‘UBICACIÓN FICHERO DE CONSTANTES’;
require_once ‘ubicacionlibreria/src/Google_Client.php’;
require_once ‘ubicacionlibreria/src/Google/Service/Analytics.php‘;
session_start();
// Declaramos nuestra configuración
$googleApi = array(
‘id’ => ID, // Id que nos ha dado la APIs Console
‘email’ => EMAIL’, // email que nos ha dado la APIs Console
‘keyFile’ => FICHEROP_12// nombre del fichero llave
‘gaAccount’ => CUENTA_GA // id de la cuenta de analytics a la que nos conectamos
);
// Creamos el cliente de conexión
$client = new Google_Client();
$client->setApplicationName(NOMBRE_APP);
$client->setAssertionCredentials(
new Google_AssertionCredentials(
$googleApi[‘email’],
array(‘https://www.googleapis.com/auth/analytics.readonly’),
file_get_contents($googleApi[‘keyFile’])
)
);
$client->setClientId($googleApi[‘id’]);
$client->setAccessType(‘offline_access’);
$service = new Google_AnalyticsService($client);
?>
Es un texto un poco largo para ponerlo e un post, pero seguro que te resulta útil. Lo primero que hacemos es llamar a los archivos donde están las constantes y las funciones necesarias para establecer el acceso sin necesidad de introducir constantemente login y password. no se a vosotros, pero a mi me parece bastante útil…
Ten en cuenta las rutas dónde ubicas la librería, las constantes y todo lo demás, ya que tendrás que cambiar el texto que te proporciono para poner bien dichas rutas ( lo que tienes que cambiar está en rojo)
A partir de éste momento estamos preparados para hacer…
$id=CUENTA QUE CONSULTAMOS ga:xxxxxx;
$fechainicio=’aaaa-mm-dd’;
$fechafin=‘aaaa-mm-dd’;
$results = $analytics->data_ga->get($id,$fechainicio ,$fechafin, ‘ga:sessions’);
var_dump($results);
Con éste código podrás ver la respuesta que se obtiene al pedir el número de visitas (ga:sessions) para un intervalo de fechas concreto. Es un array considerable con cantidad de información. Como el propósito de esta serie no es explicar toda la API de analyitcs, no veremos todo. Sólo veremos la parte que nos es interesante y que se encuentra en [‘rows’] que es donde se encuentran los resultados.
Pero eso será en el siguiente post, donde veremos cómo hacer las diferentes consultas y qué podemos consultar, claro.
Un abrazaco, que me voy a dormir.
PD: es cierto que os prometí una serie de descargables. al final he decidido agruparlos todos y ponerlos a vuestra disposición al final.
