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

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
Наверх