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

GetPhraseList

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

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