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

GetRefererList

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

CDBResult
CTraffic::GetRefererList(
	string &by = "ref_today",
	string &order = "desc",
	array filter = array(),
	bool &is_filtered,
	mixed limit = 10,
)

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

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

ПараметрОписание
byПоле для сортировки. Возможные значения:
  • ref_server - ссылающийся сайт;
  • ref_today - количество заходов с ссылающегося сайта за сегодня;
  • ref_yesterday - количество заходов с ссылающегося сайта за вчера;
  • ref_bef_yesterday - количество заходов с ссылающегося сайта за позавчера;
  • ref_total - суммарное количество заходов с ссылающегося сайта;
  • ref_period - количество заходов с ссылающегося сайта за установленный период времени (filter[DATE1], filter[DATE2]).
оrderПорядок сортировки. Возможные значения:
  • asc - по возрастанию;
  • desc - по убыванию.
filterМассив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
  • SITE_ID - ID сайта для которого необходимо получить статистику по ссылающимся сайтам;
  • DATE1 - начальная дата;
  • DATE2 - конечная дата.
is_filteredФлаг отфильтрованности списка ссылающихся сайтов. Если значение равно "true", то список был отфильтрован.
limitМаксимальное число записей результирующего списка. Если задано число >0, то число записей будет ограничено, иначе ограничений не будет.

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

Array
(
	[SITE_NAME] => ссылающийся сайт
	[TOTAL_REFERERS] => суммарное количество заходов с данного ссылающегося сайта
	[TODAY_REFERERS] => количество заходов с ссылающегося сайта за сегодня
	[YESTERDAY_REFERERS] => количество заходов с ссылающегося сайта за вчера
	[B_YESTERDAY_REFERERS] => количество заходов с ссылающегося сайта за позавчера
	[PERIOD_REFERERS] => количество заходов с ссылающегося сайта за установленный период времени (filter[DATE1], filter[DATE2])
)

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

<?
// получим дополнительные данные за декабрь 2007 года
$arFilter = array(
	"DATE1" => "01.12.2007",
	"DATE2" => "31.12.2007"
);

// получим список поисковых фраз и статистику по ним
$rs = CTraffic::GetRefererList(
	($by="ref_today"), 
	($order="desc"), 
	$arFilter, 
	$is_filtered, 
	false
);

while ($ar = $rs->Fetch())
{
	echo "ссылающийся сайт: ".$ar["SITE_NAME"]."<br>";
	echo "всего заходов с данного ссылающегося сайта: ".
		$ar["TOTAL_REFERERS"]."<br>";
	echo "сегодня: ".$ar["TODAY_REFERERS"]."<br>";
	echo "вчера: ".$ar["YESTERDAY_REFERERS"]."<br>";
	echo "позавчера: ".$ar["B_YESTERDAY_REFERERS"]."<br>";
	echo "в течение декабря 2005 года: ".
		$ar["PERIOD_REFERERS"]."<br>";
}
?>


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