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

GetDynamicList

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

CDBResult
CAdv::GetDynamicList(
	int adv_id,
	string &by = "s_date",
	string &order = "desc",
	array &max_min,
	array filter = array()
)

Возвращает данные по трафику рекламной кампании в разрезе по датам.

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

Параметр Описание
adv_id ID рекламной кампании.
by Поле для сортировки. Возможные значения:
  • s_date - дата
о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 Массив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • DATE_1 - дата "с"
  • DATE_2 - дата "по"

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

Array
(
	[DATE_STAT] => дата
	[DAY] => день (1-31)
	[MONTH] => месяц (1-12)
	[YEAR] => год
	[GUESTS] => посетителей на прямом заходе
	[NEW_GUESTS] => новых посетителей на прямом заходе
	[FAVORITES] => посетителей, добавивших сайт в "Избранное" на прямом заходе
	[C_HOSTS] => хостов на прямом заходе
	[SESSIONS] => сессий на прямом заходе
	[HITS] => хитов на прямом заходе
	[GUESTS_BACK] => посетителей на возврате
	[FAVORITES_BACK] => посетителей, добавивших сайт в "Избранное" на возврате
	[HOSTS_BACK] => хостов на возврате
	[SESSIONS_BACK] => сессий на возврате
	[HITS_BACK] => хитов на возврате
)

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

<?
$adv_id = 1;

// установим фильтр на декабрь 2005 года
$arFilter = array(
	"DATE1" => "01.12.2005",
	"DATE2" => "31.12.2005"
);

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

// выведем массив с максимальной и минимальной датами
echo "<pre>"; print_r($arMaxMin); echo "</pre>";    

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


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

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

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

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

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