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

GetDynamicList

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

CDBResult
CPage::GetDynamicList(
	string url,
	string &by = "s_date",
	string &order = "desc",
	array filter = array()
)

Возвращает данные по посещаемости указанной страницы (каталогу) в разрезе по дням.

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

ПараметрОписание
urlПолный путь к странице (каталогу) по которой необходимо получить данные.
byПорядок сортировки. Возможные значения:
  • s_date - дата.
оrderПорядок сортировки. Возможные значения:
  • asc - по возрастанию;
  • desc - по убыванию.
filterМассив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • DATE1 - начальное значение интервала даты;
  • DATE2 - конечное значение интервала даты;
  • ADV* - ID рекламной кампании (РК), данное поле позволяет отфильтровать только те страницы (каталоги) которые были открыты только посетителями по данной РК и соответственно получить данные по посещаемости страницы (каталога) url только этих посетителей;
  • ADV_EXACT_MATCH - если значение равно "N", то при фильтрации по ADV будет искаться вхождение;
  • ADV_DATA_TYPE - флаг "возврат или прямой заход по рекламной кампании" (используется только если указано filter["ADV"]), возможные значения:
    • B - показывать данные по посетителям только на возврате по РК;
    • P - показывать данные по посетителям только на прямом заходе по РК.
  • IS_DIR - показывать данные по разделам или страницам. Для фильтрации разделов требуется указать значение Y. Для страниц - N;

  • Если не указать ни одно из вышеперечисленных значений, то данные будут показываться в сумме как по прямому заходу так и по возврату.
* - допускается сложная логика

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

Array
(
	[DATE_STAT] => дата
	[DAY] => номер дня (1-31)
	[MONTH] => номер месяца (1-12)
	[YEAR] => год
	[COUNTER] => кол-во хитов на странице url
	[ENTER_COUNTER] => сколько раз данная страница была точкой входа
	[EXIT_COUNTER] => сколько раз данная страница была точкой выхода
)

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

<?
$url = "http://www.bitrixsoft.ru/about/index.php";

// установим фильтр на декабрь 2007 года 
// по прямым заходам с рекламной кампании 1 либо 2
$arFilter = array(
	"DATE1" => "01.12.2007",
	"DATE2" => "31.12.2007",
	"ADV"   => "1 | 2",
	"ADV_DATA_TYPE" => "P"
);

// получим набор записей
$rs = CPage::GetDynamicList(
	$url, 
	($by="s_date"), 
	($order="desc"), 
	$arFilter, 
);

// выведем все записи
while ($ar = $rs->Fetch())
{
	echo "<pre>"; print_r($ar); echo "</pre>";    
}
?>


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