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

GetDailyList

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

CDBResult
CTraffic::GetDailyList(
	string &by = "s_date",
	string &order = "desc",
	array &max_min, 
	array filter = array(),
	bool &is_filtered,
	string get_maxmin = "Y"
)

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

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

ПараметрОписание
byПоле для сортировки. Возможные значения:
  • s_id - ID записи;
  • s_date - дата;
  • s_hits - количество хитов;
  • s_hosts - количество хостов;
  • s_sessions - количество сессий;
  • s_events - количество событий;
  • s_guests - количество посетителей;
  • s_new_guests - количество новых посетителей;
  • s_favorites - количество посетителей, добавивших сайт в "Избранное".
оrderПорядок сортировки. Возможные значения:
  • asc - по возрастанию;
  • desc - по убыванию.
max_minСсылка на массив содержащий максимальную и минимальную даты из выбранного результирующего списка. Структура данного массива:
Array
(
	[DATE_FIRST] => минимальная дата
	[MIN_DAY] => день минимальной даты (1-31)
	[MIN_MONTH] => месяц минимальной даты (1-12)
	[MIN_YEAR] => год минимальной даты

	[DATE_LAST] => максимальная дата
	[MAX_DAY] => день максимальной даты (1-31)
	[MAX_MONTH] => месяц максимальной даты (1-12)
	[MAX_YEAR] => год максимальной даты 
)
filterМассив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • ID* - ID записи;
  • ID_EXACT_MATCH - если значение равно "N", то при фильтрации по ID будет искаться вхождение;
  • DATE1 - начальное значение интервала для поля "дата";
  • DATE2 - конечное значение интервала для поля "дата";
  • HITS_1 - начальное значение интервала для поля "количество хитов";
  • HITS_2 - конечное значение интервала для поля "количество хитов";
  • HOSTS_1 - начальное значение интервала для поля "количество хостов";
  • HOSTS_2 - начальное значение интервала для поля "количество хостов";
  • SESSIONS_1 - начальное значение интервала для поля "количество сессий";
  • SESSIONS_2 - конечное значение интервала для поля "количество сессий";
  • EVENTS_1 - начальное значение интервала для поля "количество событий";
  • EVENTS_2 - конечное значение интервала для поля "количество событий";
  • GUESTS_1 - начальное значение интервала для поля "количество посетителей";
  • GUESTS_2 - конечное значение интервала для поля "количество посетителей";
  • NEW_GUESTS_1 - начальное значение интервала для поля "количество новых посетителей";
  • NEW_GUESTS_2 - конечное значение интервала для поля "количество новых посетителей";
  • FAVORITES_1 - начальное значение интервала для поля "количество посетителей добавивших сайт в "Избранное"";
  • FAVORITES_2 - конечное значение интервала для поля "количество посетителей добавивших сайт в "Избранное";
  • SITE_ID* - ID сайта;
  • SITE_ID_EXACT_MATCH - если значение равно "N", то при фильтрации по SITE_ID будет искаться вхождение.
* - допускается сложная логика
is_filteredФлаг отфильтрованности результирующего списка. Если значение равно "true", то список был отфильтрован.
get_maxminЕсли значение данной переменной равно "Y", то в параметр max_min будет возвращен соответствующий массив содержащий максимальную и минимальную даты из выбранного результирующего списка.

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

Array
(
	[ID] => ID записи
	[DATE_STAT] => дата
	[DAY] => день (1-31)
	[MONTH] => месяц (1-12)
	[YEAR] => год
	[WDAY] => номер дня недели
		(0 - понедельник,
		1 - вторник, ... 
		6 - воскресенье)
	[HITS] => количество хитов
	[C_HOSTS] => количество хостов
	[SESSIONS] => количество сессий
	[C_EVENTS] => количество событий
	[GUESTS] => количество посетителей
	[NEW_GUESTS] => количество новых посетителей
	[FAVORITES] => количество посетителей, добавивших сайт в "Избранное"
	[TOTAL_HOSTS] => количество хостов
	[AM_AVERAGE_TIME] => среднее время длительности сессии
	[AM_1] => количество сессий длительность которых менее 1 минуты
	[AM_1_3] => количество сессий длительность которых от 1 до 3 минут
	[AM_3_6] => количество сессий длительность которых от 3 до 6 минут
	[AM_6_9] => количество сессий длительность которых от 6 до 9 минут
	[AM_9_12] => количество сессий длительность которых от 9 до 12 минут
	[AM_12_15] => количество сессий длительность которых от 12 до 15 минут
	[AM_15_18] => количество сессий длительность которых от 15 до 18 минут
	[AM_18_21] => количество сессий длительность которых от 18 до 21 минут
	[AM_21_24] => количество сессий длительность которых от 21 до 24 минут
	[AM_24] => количество сессий длительность которых более 24 минут
	[AH_AVERAGE_HITS] => среднее количество хитов в сессии
	[AH_1] => количество сессий в которых был только 1 хит
	[AH_2_5] => количество сессий в которых было от 2 до 5 хитов
	[AH_6_9] => количество сессий в которых было от 6 до 9 хитов
	[AH_10_13] => количество сессий в которых было от 10 до 13 хитов
	[AH_14_17] => количество сессий в которых было от 14 до 17 хитов
	[AH_18_21] => количество сессий в которых было от 18 до 21 хитов
	[AH_22_25] => количество сессий в которых было от 22 до 25 хитов
	[AH_26_29] => количество сессий в которых было от 26 до 29 хитов
	[AH_30_33] => количество сессий в которых было от 30 до 33 хитов
	[AH_34] => количество сессий в которых было более 34 хитов
)

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

<?
// ограничимся данными только за декабрь 2007 года
$arFilter = array(
	"DATE1" => "01.12.2007",
	"DATE2" => "31.12.2007"
);

// получим данные по посещаемости
$rsDays = CTraffic::GetDailyList(
	($by="s_date"), 
	($order="desc"), 
	$arMaxMin, 
	$arFilter, 
	$is_filtered
);

while ($arDay = $rsDays->Fetch())
{
	echo "дата: ".$arDay["DATE_STAT"]."<br>";
	echo "количество хитов: ".$arDay["HITS"]."<br>";
	echo "количество хостов: ".$arDay["C_HOSTS"]."<br>";
	echo "количество сессий: ".$arDay["SESSIONS"]."<br>";
	echo "количество событий: ".$arDay["C_EVENTS"]."<br>";
	echo "количество посетителей: ".$arDay["GUESTS"]."<br>";
}
?>


Пользовательские комментарии

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

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх