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

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-2023, «1С-Битрикс», 2023