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

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