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

GetCommonValues

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

array
CTraffic::GetCommonValues(
 array filter = array()
)

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

Примечание: при фильтрации по сайту (filter[SITE_ID]), будут доступны только данные по хитам, хостам, сессиям, событиям. Данные по посетителям будут отсутствовать, т.к. текущая версия модуля предполагает, что посетитель один на весь портал.

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

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

Возвращаемое значение

В случае если не установлена фильтрация по сайту, то структура возвращаемого массива будет следующей:

Array
(
    [TOTAL_HITS] => суммарное количество хитов за все время ведения статистики
    [TOTAL_SESSIONS] => суммарное количество сессий за все время ведения статистики
    [TOTAL_EVENTS] => суммарное количество событий за все время ведения статистики
    [TOTAL_HOSTS] => суммарное количество хостов за все время ведения статистики
    [TOTAL_GUESTS] => суммарное количество посетителей за все время ведения статистики
    [TOTAL_FAVORITES] => суммарное количество посетителей, добавивших сайт в
                         "Избранное" за все время ведения статистики

    [TODAY_HITS] => количество хитов за сегодня
    [TODAY_SESSIONS] => количество сессий за сегодня
    [TODAY_EVENTS] => количество событий за сегодня
    [TODAY_HOSTS] => количество хостов за сегодня
    [TODAY_GUESTS] => суммарное количество посетителей за сегодня
    [TODAY_NEW_GUESTS] => количество новых посетителей  за сегодня
    [TODAY_FAVORITES] => количество посетителей, добавивших сайт в
                         "Избранное", за сегодня

    [YESTERDAY_HITS] => количество хитов за вчера
    [YESTERDAY_SESSIONS] => количество сессий за вчера
    [YESTERDAY_EVENTS] => количество событий за вчера
    [YESTERDAY_HOSTS] => количество хостов за вчера
    [YESTERDAY_GUESTS] => суммарное количество посетителей за вчера
    [YESTERDAY_NEW_GUESTS] => количество новых посетителей за вчера
    [YESTERDAY_FAVORITES] => количество посетителей, добавивших сайт в
                             "Избранное", за вчера

    [B_YESTERDAY_HITS] => количество хитов за позавчера
    [B_YESTERDAY_SESSIONS] => количество сессий за позавчера
    [B_YESTERDAY_EVENTS] => количество событий за позавчера
    [B_YESTERDAY_HOSTS] => количество хостов за позавчера
    [B_YESTERDAY_GUESTS] => суммарное количество посетителей за позавчера
    [B_YESTERDAY_NEW_GUESTS] => количество новых посетителей за позавчера
    [B_YESTERDAY_FAVORITES] => количество посетителей, добавивших сайт в
                               "Избранное", за позавчера

    [PERIOD_HITS] => количество хитов за установленный период времени
                     (filter[DATE1], filter[DATE2])
    [PERIOD_SESSIONS] => количество сессий за установленный период времени
    [PERIOD_EVENTS] => количество событий за установленный период времени
    [PERIOD_NEW_GUESTS] => количество новых посетителей за установленный
                           период времени
    [PERIOD_FAVORITES] => количество посетителей, добавивших сайт в
                          "Избранное", за установленный период времени

    [ONLINE_GUESTS] => количество посетителей в online
)

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

<?
// получим данные по посещаемости сайта
$arr = CTraffic::GetCommonValues();

echo "Всего хитов: ".$arr["TOTAL_HITS"];
echo "Сегодня хитов: ".$arr["TODAY_HITS"];

echo "Всего хостов: ".$arr["TOTAL_HOSTS"];
echo "Сегодня хостов: ".$arr["TODAY_HOSTS"];

echo "Всего посетителей: ".$arr["TOTAL_GUESTS"];
echo "Сегодня посетителей: ".$arr["TODAY_GUESTS"];
echo "Посетителей в онлайн: ".$arr["ONLINE_GUESTS"];
?>


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

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

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

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

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