GetList
Описание и параметры
CDBResult CReferer::GetList( string &by = "s_id", string &order = "desc", array filter = array(), bool &is_filtered, int &total, string &group_by, int &max )
Возвращает список ссылающихся сайтов (страниц).
Параметры метода
| Параметр | Описание |
|---|---|
| by | Поле для сортировки. В зависимости от группировки списка, набор доступных значений данной переменной может быть различным.
|
| оrder | Порядок сортировки. Возможные значения:
|
| filter | Массив для фильтрации результирующего списка. В массиве допустимы следующие ключи:
|
| is_filtered | Флаг отфильтрованности результирующего списка. Если значение равно "true", то список был отфильтрован. |
| total | Суммарные количество заходов с ссылающихся страниц. |
| group_by | Группировка результирующего списка. Возможные значения:
|
| max | Количество заходов с самой популярной ссылающейся страницы. |
Смотрите также
Структура возвращаемой записи
В зависимости от установленной группировки, структура возвращаемой записи различная.
- при группировке по ссылающейся странице (filter["GROUP"]="U"):
Array ( [URL_FROM] => ссылающаяся страница [QUANTITY] => сколько раз зашли с данной ссылающейся страницы [PERCENT] => процент заходов с данной ссылающейся страницы, относительно всех заходов со всех ссылающихся сайтов [AVERAGE_HITS] => среднее количество хитов, производимое посетителями, заходящими с данной ссылающейся страницы )
- при группировке по ссылающемуся домену (filter["GROUP"]="S"):
Array ( [URL_FROM] => ссылающийся домен [QUANTITY] => сколько раз зашли с данного ссылающегося домена [PERCENT] => процент заходов с данного ссылающегося домена, относительно всех заходов со всех ссылающихся сайтов [AVERAGE_HITS] => среднее количество хитов, производимое посетителями, заходящими с данного ссылающегося домена )
- когда группировка не установлена:
Array ( [ID] => ID записи [URL_FROM] => ссылающаяся страница [DATE_HIT] => дата [SESSION_ID] => ID сессии [URL_TO] => страница, на которую пришли [URL_TO_404] => [Y|N] флаг 404 ошибки на странице на которую пришли [SITE_ID] => ID сайта на который пришли )
Примеры использования
<?
// отфильтруем только заходы с доменов "google"
// сгруппировав по ссылающемуся домену
$arFilter = array(
"FROM_DOMAIN" => "google",
"GROUP" => "S"
);
// получим список записей
$rs = CReferer::GetList(
($by = "s_url_from"),
($order = "desc"),
$arFilter,
$is_filtered,
$total,
$group_by,
$max
);
// выведем все записи
while ($ar = $rs->Fetch())
{
echo "<pre>"; print_r($ar); echo "</pre>";
}
?>
© «Битрикс», 2001-2025, «1С-Битрикс», 2025