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-2024, «1С-Битрикс», 2024