/**
* <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);
}
}
