Google Analytics является неотъемлемой частью анализа посещаемости вашего сайта. И с выпуском Analytics API программисты получили еще больше возможностей в создании пользовательских отчетов. Хотя не существует официальной библиотеки от гугла для работы с аналитиком, существуют несколько простых классов, к примеру, GAPI, о котором речь пойдет дальше.

Сразу рассмотрим небольшой пример.

require 'gapi.class.php';
 
define('ga_account', 'YOUR ANALYTICS EMAIL');
define('ga_password', 'YOUR ANALYTICS PASSWORD');
define('ga_profile_id', 'ANALYTICS SITE PROFILE ID');
 
$ga = new gapi(ga_account,ga_password);
 
$dimensions = array('source');
$metrics = array('visits');
 
$ga->requestReportData(ga_profile_id, $dimensions, $metrics,'-visits');
 
$gaResults = $ga->getResults();
 
$i=1;
 
foreach($gaResults as $result)
{
	printf("%-4d %-40s %5d\n",
		$i++,
		$result->getSource(),
		$result->getVisits());
}
 
echo "\n-----------------------------------------\n";
echo "Total Results : {$ga->getTotalResults()}";

Для подключения к серверу статистики необходимы ваш логин и пароль. Чтобы узнать идентификатор вашего профиля ga_profile_id, откройте в браузере статистику вашего аналитика, и посмотрите на адресную строку:

https://www.google.com/analytics/reporting/?reset=1&id=12345678&pdr=20100119-20100218

В аналитике используются понятия метрики (metrics) и измерения (dimensions).

К измерениям относятся браузеры и их версии, страны, URL страниц, ссылки, источники переходов и т.д.

Метрика - количественная мера измерений, метрикой могут быть количество новых посетителей, просмотры страниц и т.д.

Наш пример выводит количество посетителей в зависимости от источника перехода.

No.		Source					 Visits
------------------------------------------------------
1		google						10549
2		(direct)						1484
3		stumbleupon.com				1338
4		webintenta.com				159
5		bing							142
6		yahoo						115
7		feedburner					97
8		phpdeveloper.org				70
9		t3n.de						64
10		clearspace.openqa.org			43 

Как вы заметили, основная функция requestReportData отвечает за получении статистики.

function requestReportData($report_id,	// идентификатор профиля
	$dimensions,		// измерения
	$metrics, 			// метрика
	$sort_metric=null, 	// сортировка
	$filter=null, 		// фильтр
	$start_date=null, 	// начало периода 
	$end_date=null, 	// конец периода 
	$start_index=1, 	// начальный элемент выдачи
	$max_results=30)	// количество элементов в выдаче

Чтобы задать сортировку по метрике, передайте название метрики 4 параметром, знак минус перед ней означает сортировку в обратном порядке.

function requestReportData($report_id,
	$dimensions,
	$metrics,
	'-visits')

Подробно про фильтры почитайте в официальной документации.

В своем блоге я использовал аналитик для определения списка популярных статей. Для этого мне понадобились измерение 'pagePath', метрика 'pageviews' и фильтр 'pagePath =~ ^vkurseweba.ru/blog/'.

require 'gapi.class.php';
$ga = new gapi(ga_email,ga_password);

$dimensions = array('pagePath');
$metrics    = array('pageviews');
$filter = "pagePath =~ ^$template";

$ga->requestReportData(ga_profile_id,
	$dimensions,
	$metrics,
	'-pageviews',
	$filter,
	'',
	'',
	1,
	500
);

$gaResults = $ga->getResults();
 
$i = 1;

foreach($gaResults as $result)
{
	printf("%-4d %-40s %5d\n",
		$i++,
		$pagePath,
		$result->getPageviews());
}

Другой пример использования описан в статье FeedCount-Like Google Analytics Counter. Авторы используют аналитик для счетчика посещений на сайте в стиле FeedCount.

При написании статьи использовались материалы Reading Google Analytics data from PHP.