CTraffic – класс для получения данных по посещаемости в Битриксе

Ниже приведена подробная статья о возможностях класса CTraffic модуля Веб-аналитика в 1С-Битрикс, который используется для получения обобщенных данных по посещаемости сайта. В статье вы найдете описание каждого метода, примеры кода и рекомендации по сбору данных за различные периоды времени.

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

<?
if(CModule::IncludeModule("statistic"))
{  
	//здесь можно использовать функции и классы модуля
} 
?>

Что такое CTraffic

CTraffic – это класс в 1С-Битрикс, предназначенный для работы со статистикой посещаемости сайта. С его помощью можно получать сведения о количестве хитов, уникальных посетителей, поисковых фразах, ссылающихся сайтах и т.д. Класс позволяет не только собирать общую статистику, но и смотреть статистику за определенные временные промежутки.

Когда может понадобиться использование CTraffic

1. Создание собственных отчетов по посещаемости.
2. Анализ эффективности рекламных кампаний (источники, фразы, переходы).
3. Отслеживание общей динамики трафика (по дням, месяцам, часам).
4. Отображение метрик в собственном интерфейсе администратора или на внешнем портале.

Методы класса CTraffic

1. GetCommonValues

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

<?php
// Предположим, у нас есть начальная и конечная даты
$date1 = "2025-01-01";
$date2 = "2025-01-31";

// Подготовка параметров фильтра
$filter = [
    "DATE1" => $date1,
    "DATE2" => $date2,
];

// Получаем общие значения статистики
$commonValues = CTraffic::GetCommonValues($filter);

// Выводим результат
print_r($commonValues);
?>

2. GetDailyList

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

<?php
$date1 = "2025-02-01";
$date2 = "2025-02-10";

$filter = [
    "DATE1" => $date1,
    "DATE2" => $date2,
];

// Получаем список статистики по дням
$dailyList = CTraffic::GetDailyList($filter);

print_r($dailyList);
?>

3. GetPhraseList

GetPhraseList позволяет получить статистику по поисковым фразам за весь период, за последние 3 дня или за произвольный указанный интервал времени.

<?php
$date1 = "2025-01-01";
$date2 = "2025-02-01";

$filter = [
    "DATE1" => $date1,
    "DATE2" => $date2,
];

// Получаем статистику по поисковым фразам
$phraseList = CTraffic::GetPhraseList($filter);

print_r($phraseList);
?>

4. GetRefererList

GetRefererList возвращает статистику по ссылающимся сайтам за весь период, за последние 3 дня или за произвольный временной интервал.

<?php
$date1 = "2024-12-01";
$date2 = "2025-01-01";

$filter = [
    "DATE1" => $date1,
    "DATE2" => $date2,
];

// Получаем список ссылающихся сайтов
$refererList = CTraffic::GetRefererList($filter);

print_r($refererList);
?>

5. GetSumList

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

<?php
$filter = [
    // "DATE1" => "2025-01-01",
    // "DATE2" => "2025-01-31",
];

// Получаем сводные данные
$sumList = CTraffic::GetSumList($filter);

print_r($sumList);
?>

Сбор данных за различные периоды

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

<?php
// Получаем дату "сегодня" и дату "7 дней назад"
$date2 = date("Y-m-d");
$date1 = date("Y-m-d", strtotime("-7 days"));

$filter = [
    "DATE1" => $date1,
    "DATE2" => $date2,
];

// Например, соберем общие значения:
$commonWeeklyValues = CTraffic::GetCommonValues($filter);
print_r($commonWeeklyValues);

// Или возьмем фразы за последние 7 дней:
$phraseWeeklyList = CTraffic::GetPhraseList($filter);
print_r($phraseWeeklyList);
?>

Заключение

Класс CTraffic предоставляет гибкую функциональность по сбору и анализу статистики посетителей в 1С-Битрикс. Благодаря возможности указывать произвольные интервалы времени, вы можете настроить собственные отчеты и следить за динамикой трафика. Использование методов GetCommonValues, GetDailyList, GetPhraseList, GetRefererList и GetSumList дает почти все основные метрики, необходимые для понимания поведения аудитории на сайте.

Если вам нужно получать расширенные данные или специфичные отчеты, вы можете комбинировать вызовы методов и дополнительно накладывать фильтры по рекламным кампаниям, геолокации или иным параметрам (при условии, что модуль веб-аналитики Bitrix собирает соответствующие данные).