GetList
Описание и параметры
CDBResult CPhrase::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"]="P"):
Array ( [PHRASE] => поисковая фраза [QUANTITY] => сколько раз заходили на сайт по данной поисковой фразе [PERCENT] => процент от общего количества заходов по разным поисковым фразам )
- при группировке по поисковой системе (filter["GROUP"]="S"):
Array ( [SEARCHER_ID] => ID поисковой системы [SEARCHER_NAME] => название поисковой системы [QUANTITY] => количество заходов с поисковой системы [PERCENT] => процент заходов с данной поисковой системы [AVERAGE_HITS] => среднее количество хитов, производимое посетителями, заходящими с той или иной поисковой системы )
- когда группировка не установлена:
Array ( [ID] => ID записи [PHRASE] => поисковая фраза [DATE_HIT] => время [SESSION_ID] => ID сессии [REFERER_ID] => ID записи из таблицы ссылающихся сайтов (страниц) [SEARCHER_ID] => ID поисковой системы [SEARCHER_NAME] => название поисковой системы [URL_TO] => страница на которую пришли [URL_TO_404] => [Y|N] флаг 404 ошибки на странице, на которую пришли [SITE_ID] => ID сайта, на который пришли )
Примеры использования
<? // отфильтруем только те поисковые фразы // которые искали на сайте с помощью внутреннего поиска $arFilter = array( "SEARCHER_ID" => 1 ); // получим список записей $rs = CPhrase::GetList( ($by = "s_id"), ($order = "desc"), $arFilter, $is_filtered, $total, $group_by, $max ); // выведем все записи while ($ar = $rs->Fetch()) { echo ""; print_r($ar); echo ""; } ?>
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.