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

AddCurrent

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

array
CStatEvent::AddCurrent(
	string event1,
	string event2 = "",
	string event3 = "",
	mixed money = "",
	string currency = "",
	string goto = "",
	string chargeback = "N",
	mixed site_id = false
)

Добавляет событие используя текущие параметры посетителя. Если типа события с идентификаторами event1, event2 не существует, то он будет автоматически создан с указанными идентификаторами.

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

ПараметрОписание
event1Идентификатор типа события event1.
event2Идентификатор типа события event2.
event3Дополнительный параметр event3 события.
moneyДенежная сумма.
currencyТрехсимвольный идентификатор валюты. Идентификаторы валют задаются в модуле "Валюты".
gotoАдрес страницы куда перешел посетитель. Как правило используется в скриптах вида /bitrix/redirect.php, перенаправляющих посетителей на другие страницы с одновременной фиксацией события.
chargebackФлаг отрицательной суммы. Используется когда необходимо зафиксировать событие о возврате денег (chargeback). Возможные значения:
  • Y - денежная сумма отрицательная;
  • N - денежная сумма положительная.
site_idID сайта к которому будет привязано будущее событие.

Возвращаемое значение

Метод возвращает массив вида:

Array
(
	[TYPE_ID] => ID типа события
	[EID] => ID добавленного события
)

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

<?
// зафиксируем событие типа "Просмотр спец. страницы" (view/special_page)
CStatEvent::AddCurrent("softkey", "out", $GLOBALS["APPLICATION"]->GetCurPage());
?>
<?
// зафиксируем событие типа "Уход на оплату заказа на Софткее" (softkey/out)
// если такого типа не существует, то он будет автоматически создан
// событие будет фиксироваться по параметрам текущего посетителя сайта

// в данной переменной может быть задана страница на которую осуществляется переход
$goto = "http://www.softkey.ru/catalog/basket.php?prodid=902&quantity=1&referer1=ritlabs_site&referer2=BITRIX_SM.OTk1LjgyLk4wLjI1Lk4ucnU%3D";

CStatEvent::AddCurrent("softkey", "out", "", "", "", $goto);
?>
<?
// зафиксируем событие типа "Скачивание файла manual.chm" (download/manual)
// если такого типа не существует, то он будет автоматически создан
// событие будет фиксироваться по параметрам текущего посетителя сайта

// сначала проверим не скачивал ли уже текущий посетитель этот файл
// в течение последнего часа

// получим ID типа события
$rs = CStatEventType::GetByEvents($event1, $event2);
if ($ar = $rs->Fetch())
{
	// теперь получим все события данного типа для текущего посетителя сайта
	// произошедшие за последний час (3600 секунд)
	$rs = CStatEvent::GetListByGuest($_SESSION["SESS_GUEST_ID"], $ar["TYPE_ID"], "", 3600);
    
	// если таких событий не было то
	if (!($ar=$rs->Fetch()))
	{
		// добавляем данное событие
		CStatEvent::AddCurrent("download", "manual");
	}
}
?>


Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх