Документация для разработчиков
Темная тема

GetSumList

Описание и параметры

CDBResult
CTraffic::GetSumList(
	string data_type,
	array filter = array(),
)

Возвращает количество хитов, хостов, сессий, посетителей, событий в разрезе по часам, дням недели и месяцам.

Параметры метода

ПараметрОписание
data_typeТип данных. Возможные значения:
  • hour - данные в разрезе по часам;
  • weekday - данные в разрезе по дням недели;
  • month - данные в разрезе по месяцам.
filterМассив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • SITE_ID - ID сайта для которого необходимо получить статистику по ссылающимся сайтам;
  • DATE1 - начальная дата;
  • DATE2 - конечная дата.

Смотрите также

Структура возвращаемой записи

В зависимости от значения параметра data_type, структура возвращаемой записи различная.

  • при получении данных в разрезе по часам (data_type=hour):
    Array
    (
    	[HOUR_HOST_0] => число хостов, зафиксированных с 0:00 до 1:00 часа
    	...
    	[HOUR_HOST_23] => число хостов, зафиксированных с 23:00 до 0:00
    
    	[HOUR_SESSION_0] => число сессий, зафиксированных с 0:00 до 1:00 часа
    	...
    	[HOUR_SESSION_23] => число сессий, зафиксированных с 23:00 до 0:00
        
    	[HOUR_HIT_0] => число хитов, зафиксированных с 0:00 до 1:00 часа
    	...
    	[HOUR_HIT_23] => число хитов, зафиксированных с 23:00 до 0:00
        
    	[HOUR_EVENT_0] => число событий, зафиксированных с 0:00 до 1:00 часа
    	...
    	[HOUR_EVENT_23] => число событий, зафиксированных с 23:00 до 0:00
        
    	[HOUR_GUEST_0] => число посетителей, зафиксированных с 0:00 до 1:00 часа
    	...
    	[HOUR_GUEST_23] => число посетителей, зафиксированных с 23:00 до 0:00
        
    	[HOUR_NEW_GUEST_0] => число новых посетителей, зафиксированных с 0:00 до 1:00 часа
    	...
    	[HOUR_NEW_GUEST_23] => число новых посетителей, зафиксированных с 23:00 до 0:00
        
    	[HOUR_FAVORITE_0] => число посетителей, добавивших сайт в "Избранное", зафиксированных с 0:00 до 1:00 часа
    	...
    	[HOUR_FAVORITE_23] => число посетителей, добавивших сайт в "Избранное", зафиксированных с 23:00 до 0:00
    )
  • при получении данных в разрезе по дням недели (data_type=weekday):
    Array
    (
    	[WEEKDAY_HOST_0] => число хостов, зафиксированных в воскресенье
    	[WEEKDAY_HOST_1] => число хостов, зафиксированных в понедельник
    	...
    	[WEEKDAY_HOST_6] => число хостов, зафиксированных в субботу
    
    	[WEEKDAY_SESSION_0] => число сессий, зафиксированных в воскресенье
    	[WEEKDAY_SESSION_1] => число сессий, зафиксированных в понедельник
    	...
    	[WEEKDAY_SESSION_6] => число сессий, зафиксированных в субботу
    
    	[WEEKDAY_HIT_0] => число хитов, зафиксированных в воскресенье
    	[WEEKDAY_HIT_1] => число хитов, зафиксированных в понедельник
    	...
    	[WEEKDAY_HIT_6] => число хитов, зафиксированных в субботу
    
    	[WEEKDAY_EVENT_0] => число событий, зафиксированных в воскресенье
    	[WEEKDAY_EVENT_1] => число событий, зафиксированных в понедельник
    	...
    	[WEEKDAY_EVENT_6] => число событий, зафиксированных в субботу
    
    	[WEEKDAY_GUEST_0] => число посетителей, зафиксированных в воскресенье
    	[WEEKDAY_GUEST_1] => число посетителей, зафиксированных в понедельник
    	...
    	[WEEKDAY_GUEST_6] => число посетителей, зафиксированных в субботу
    
    	[WEEKDAY_NEW_GUEST_0] => число новых посетителей, зафиксированных в воскресенье
    	[WEEKDAY_NEW_GUEST_1] => число новых посетителей, зафиксированных в понедельник
    	...
    	[WEEKDAY_NEW_GUEST_6] => число новых посетителей, зафиксированных в субботу
    
    	[WEEKDAY_FAVORITE_0] => число посетителей, добавивших сайт в "Избранное", зафиксированных в воскресенье
    	[WEEKDAY_FAVORITE_1] => число посетителей, добавивших сайт в "Избранное", зафиксированных в понедельник
    	...
    	[WEEKDAY_FAVORITE_6] => число посетителей, добавивших сайт в "Избранное", зафиксированных в субботу
    )
  • при получении данных в разрезе по месяцам (data_type=month):
    Array
    (
    	[MONTH_HOST_1] => число хостов, зафиксированных в январе
    	...
    	[MONTH_HOST_12] => число хостов, зафиксированных в декабре
        
    	[MONTH_SESSION_1] => число сессий, зафиксированных в январе
    	...
    	[MONTH_SESSION_12] => число сессий, зафиксированных в декабре
    
    	[MONTH_HIT_1] => число хитов, зафиксированных в январе
    	...
    	[MONTH_HIT_12] => число хитов, зафиксированных в декабре
    
    	[MONTH_EVENT_1] => число событий, зафиксированных в январе
    	...
    	[MONTH_EVENT_12] => число событий, зафиксированных в декабре
    
    	[MONTH_GUEST_1] => число посетителей, зафиксированных в январе
    	...
    	[MONTH_GUEST_12] => число посетителей, зафиксированных в декабре
    
    	[MONTH_NEW_GUEST_1] => число новых посетителей, зафиксированных в январе
    	...
    	[MONTH_NEW_GUEST_12] => число новых посетителей, зафиксированных в декабре
    
    	[MONTH_FAVORITE_1] => число посетителей, добавивших сайт в "Избранное", зафиксированных в январе
    	...
    	[MONTH_FAVORITE_12] => число посетителей, добавивших сайт в "Избранное", зафиксированных в декабре
    )

Примеры использования

<?
// получим данные по посещаемости в разрезе по дням недели
$rs = CTraffic::GetSumList("weekday");
$ar = $rs->Fetch();
for ($i=0; $i<=6; $i++)
{
	switch($i)
	{
		case 0: echo "воскресенье"; break;
		case 1: echo "понедельник"; break;
		case 2: echo "вторник"; break;
		case 3: echo "среда"; break;
		case 4: echo "четверг"; break;
		case 5: echo "пятница"; break;
		case 6: echo "суббота"; break;
	}
	echo "<br>";
	echo "Хостов: ".$ar["WEEKDAY_HOST_".$i]."<br>";
	echo "Сессий: ".$ar["WEEKDAY_SESSION_".$i]."<br>";
	echo "Хитов: ".$ar["WEEKDAY_HIT_".$i]."<br>";
	echo "Посетителей: ".$ar["WEEKDAY_GUEST_".$i]."<br>";
	echo "Новых посетителей: ".$ar["WEEKDAY_NEW_GUEST_".$i]."<br>";
	echo "<br><br>";
}
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024