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). Возможные значения:
|
site_id | ID сайта к которому будет привязано будущее событие. |
Возвращаемое значение
Метод возвращает массив вида:
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
Пользовательские комментарии
Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.Для этого нужно всего лишь авторизоваться на сайте
Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.
Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.