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

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-2022, «1С-Битрикс», 2022
Наверх