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

GetPhraseList

Array

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

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

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

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

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

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

Array
(
    [PHRASE] => поисковая фраза
    [TOTAL_PHRASES] => суммарное количество заходов
                       с данной поисковой фразой
    [TODAY_PHRASES] => сколько раз сегодня заходили
                       с данной поисковой фразой
    [YESTERDAY_PHRASES] => сколько раз вчера заходили
                           с данной поисковой фразой
    [B_YESTERDAY_PHRASES] => сколько раз позавчера заходили
                             с данной поисковой фразой
    [PERIOD_PHRASES] => сколько раз заходили с данной
                        поисковой фразой за установленный период времени
                        (filter[DATE1], filter[DATE2])
)

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

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

// получим список поисковых фраз и статистику по ним
$rs = CTraffic::GetPhraseList($by="s_today", 
                              $order="desc", 
                              $arFilter, 
                              $is_filtered, 
                              false);
while ($ar = $rs->Fetch())
{
    echo "поисковая фраза: ".$ar["PHRASE"]."<br>";
    echo "всего заходов с данной поисковой фразой: ".
         $ar["TOTAL_PHRASES"].
         "<br>";
    echo "сегодня: ".$ar["TODAY_PHRASES"]."<br>";
    echo "вчера: ".$ar["YESTERDAY_PHRASES"]."<br>";
    echo "позавчера: ".$ar["B_YESTERDAY_PHRASES"]."<br>";
    echo "в течение декабря 2005 года: ".
         $ar["PERIOD_PHRASES"]."<br>";
}
?>


© «Битрикс», 2001-2023, «1С-Битрикс», 2023
Наверх