API - Google Analytics sur votre site

Par FlUxIuS 2008-09-03 { Catégorie : PHP }

"Faites voir vos statistiques !"

Non google n'a pas fait d'API, mais Slashon "OUI !". Dans cet article, nous vous détaillerons la phase d'installation à suivre pour profiter du service Analytics de google récupérer le rapport en PDF, XML, CSV, TSV.

Encore une nouvelle création de ma part, l'API GAnalytics (Non-officiel) avec pour but d'exposer vos statistiques sur votre site web.

Pré-requis : Apache 2, PHP 5.1 et cURL

Installation

Téléchargez le fichier compressé : http://www.slashon.com/API-GAnalytics.zip

Après cela, décompressez le fichier et récupérez le fichier "GAnalytics.class.php" qui va nous permettre de générer notre rapport. Copiez-le là où vous le voulez pour pouvoir l'inclure dans un autre fichier.

Type et catégories

Comme vous avez pu le constater sur Google Analytics, nous avons 4 catégories et 4 types d'exportations possibles. Voici deux tableaux récapitulatifs :

Types :

[ id ]	Signification
0	PDF
1	XML
2	CSV
3	TSV

Categories :

Nom	Signification
DashboardReport	Tout montrer
VisitorsOverviewReport	Vue d'ensemble des visiteurs
TrafficSourcesReport	Vue d'ensemble des sources de trafic
ContentReport	Vue d'ensemble du contenu

Voici maintenant un tableau des compatibilitées entre les types et les catégories :

	DashboardReport	VisitorsOverviewReport	TrafficSourcesReport	ContentReport
0
1
2
3

Ces informations sont très importantes afin de faire fonctionner convenablement l'API. Nous allons maintenant procéder à la création de notre rapport avec le code suivant (en exemple) :

<?php
/*
	Generate a PDF report
*/
 
include ('../GAnalytics.class.php'); // Include the class
$google = new GAnalytics('sebastien.dudek@gmail.com', 'password'); // API initialization 
$google->connect('8467259', 'fr_FR'); // Site ID, Language (en_US by default)
$google->query('DashboardReport', 0); // Category, Extension
$google->close(); // Close the connection
?>

connect(ID, Langue) : Permet de se connecter à votre compte google.

query(Categorio, type) : Génére le rapport souhaité

close() : Fermeture obligatoire !

Option avancées :

Vous pouvez spécifier une date de début et de fin à analyser : $bdate et $ldate.

Utilisation :

<?php
/*
	Generate a PDF report
*/
 
include ('../GAnalytics.class.php'); // Include the class
$google = new GAnalytics('sebastien.dudek@gmail.com', 'password'); // API initialization 
$google->connect('8467259', 'fr_FR'); // Site ID, Language (en_US by default)
$google->bdate = 20080503; // Starting Date (Yearmonthday) : 1 month earlier by default
$google->ldate = 20080603; // Ending date (Yearmonthday) : This date by default
$google->query('DashboardReport', 0); // Category, Extension
$google->close(); // Close the connection
?>