/** * <p>Добавляет <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#event">событие</a> по заданным <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#event_type_id">идентификаторам</a> <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#event_type">типа события</a> и <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#gid">специальному параметру</a>. Если <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#event_type">типа события</a> с идентификаторами <i>event1</i>, <i>event2</i> не существует, то он будет автоматически создан с указанными идентификаторами.</p> * * * @param string $event1 Идентификатор типа события event1. * * @param string $event2 Идентификатор типа события event2. * * @param string $event3 <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#event3">Дополнительный параметр * event3</a> события. * * @param string $date Дата в <a href="http://dev.1c-bitrix.ru/api_help/main/general/constants.php#format_datetime">текущем * формате</a>. * * @param string $gid <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#gid">Специальный параметр</a> в * котором закодированы все необходимые данные для добавления * события. * * @param mixed $money = "" Денежная сумма. * * @param string $currency = "" Трехсимвольный идентификатор валюты. Идентификаторы валют * задаются в модуле "Валюты". * * @param string $chargeback = "N" Флаг отрицательной суммы. Используется когда необходимо * зафиксировать событие о возврате денег (chargeback). Возможные * значения: <ul> <li> <b>Y</b> - денежная сумма отрицательная; </li> <li> <b>N</b> - * денежная сумма положительная. </li> </ul> * * @return int <p>Метод возвращает ID добавленного события в случае успеха, и 0, * если событие не было добавлено по каким либо причинам.</p> * * <h4>Example</h4> * <pre> * <? * // добавим событие по типу softkey/buy * // если такого типа нет, то он автоматически будет создан * * // специальный параметр события в незакодированном виде * $gid = "BITRIX_SM.995.82.N0.25.N.ru"; * * // дата должна быть заданы в формате текущего сайта или языка * $date = "23.12.2005 18:15:10"; * * <b>CStatEvent::AddByEvents</b>("softkey", "buy", "", $date, $gid, "899", "USD"); * ?> * * * <? * // добавим событие по типу regnow/buy * // если такого типа нет, то он автоматически будет создан * * // специальный параметр события в закодированном виде * $gid = "BITRIX_SM.OTk1LjgyLk4wLjI1Lk4ucnU%3D"; * * // дата должна быть заданы в формате текущего сайта или языка * $date = "01.06.2005"; * * <b>CStatEvent::AddByEvents</b>("regnow", "buy", "", $date, $gid, "199", "EUR"); * ?> * </pre> * * * <h4>See Also</h4> * <ul> <li> <a href="http://dev.1c-bitrix.ru/api_help/statistic/classes/cstatevent/add.php">CStatEvent::Add</a> </li> <li> * <a href="http://dev.1c-bitrix.ru/api_help/statistic/classes/cstatevent/addcurrent.php">CStatEvent::AddCurrent</a> </li> * <li> <a href="http://www.1c-bitrix.ru/user_help/statistic/events/event_edit.php">Загрузка событий</a> * </li> <li> <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#event">Термин "Событие"</a> </li> * <li> <a href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#event3">Термин "Дополнительный * параметр события (event3)"</a> </li> <li> <a * href="http://dev.1c-bitrix.ru/api_help/statistic/terms.php#gid">Термин "Специальный параметр * события"</a> </li> </ul> <a name="examples"></a> * * * @static * @link http://dev.1c-bitrix.ru/api_help/statistic/classes/cstatevent/addbyevents.php * @author Bitrix */ public static function AddByEvents($EVENT1, $EVENT2, $EVENT3, $DATE_ENTER, $PARAM, $MONEY = "", $CURRENCY = "", $CHARGEBACK = "N") { $EVENT_ID = CStatEvent::SetEventType($EVENT1, $EVENT2, $arEventType); if ($EVENT_ID > 0 && strlen($PARAM) > 0) { return CStatEvent::Add($EVENT_ID, $EVENT3, $DATE_ENTER, $PARAM, $MONEY, $CURRENCY, $CHARGEBACK); } }