Загрузка событий

В этом разделе

Данная форма предназначена для занесения в базу данных событий, произошедших вне сайта. Примерами таких событий могут служить оплата заказа, отмена заказа и т.п.

Загрузка из файла

При помощи этой формы Вы можете загрузить список событий из внешнего файла в формате CSV. Формат данных в файле должен иметь следующие поля:

"[1]","[2]","[3]","[4]","[5]","[6]","[7]"

ID типа события.
Дополнительный параметр (event3).
Дата, заданная в формате даты для текущего сайта.
Дополнительный параметр в формате:

16,"file1.exe","10.10.2007 12:30","BITRIX_SM.10.5.RU.6.Y","250","USD"
16,"help_doc.chm","10.10.2007 12:30"
16,"www","BITRIX_SM.11.4.US.8.N","233.45"
16,"1С-Битрикс: Управление сайтом","BITRIX_SM.11.4.US.8.N","233.45","RUB","Y"

После нажатия кнопки Загрузить происходит чтение файла и занесение полей в следующую таблицу.

Закладка "Ручной ввод"

Помимо загрузки событий из файла, Вы можете заполнять эту таблицу вручную.

#	ID типа события *	event3	Дата	Доп. параметр	Денежная сумма	Валюта	Возврат денег
[1]	[2] [3]	[4]	[5] [6]	[7]	[8]	[9]	[10]	[11]

Порядковый номер.
ID типа события.
Иконка, вызывающая форму для выбора типа события.
Дополнительный параметр события – event3 (в нем может быть, например, сумма заказа).
Дата события.
Кнопка, открывающая календарь.
Дополнительный параметр (формат описан выше).
Денежная сумма события.
Валюта (данный столбец выводится, если в настройках модуля установлена базовая валюта, которая, в свою очередь, может быть установлена при наличии модуля валют).
Если эта опция установлена, сумма отнимается от доходов рекламной кампании. В противном случае, доход рекламной кампании увеличивается на эту сумму.
Кнопка, копирующая текущую строку в следующую.

Нажатие кнопки Загрузить регистрирует события из таблицы в базе данных.

Автоматическая регистрация событий

Когда посетитель уходит, например, на оформление заказа, то в ссылку, ведущую на внешнюю платежную систему, должен быть добавлен специальный шаблон – #EVENT_GID#. Этот шаблон в дальнейшем будет автоматически заменен (в скрипте redirect.php) на составной идентификатор:

[код сайта].[ID сессии].[ID посетителя].[ID страны].[ID
 рекламной кампании].[Y – возврат по рекламной кампании; N – прямой заход].

Пример такой ссылки:

<a href="http://www.ritlabs.ru/redirect.php?event1=softkey_out&
 event2=thebat&event3=buy&
 goto=http://www.softkey.ru/catalog/basket.php?
 prodid=902&quantity=1&referer1=ritlabs_site&referer2=#EVENT_GID#">
Купить
</a>

В приведенной ссылке кодированные символы заменены для удобства чтения. Оригинал ссылки:

<a href="http://www.ritlabs.ru/redirect.php?event1=softkey_out&
 event2=thebat&event3=buy&
 goto=http%3A//www.softkey.ru/catalog/basket.php%3Fprodid%3D902%26quantity%3D1%26referer1%3Dritlabs_site%26referer2%3D%23EVENT_GID%23">
Купить
</a>

Для задания подобных ссылок предусмотрены специальные возможности во встроенном в систему HTML-редакторе.

Большинство платежных систем принимают такой специальный параметр и возвращают его в письме, оповещающем владельца товара о заказе (например, на www.softkey.ru таких идентификаторов два: referer1 и referer2). Когда к Вам поступает письмо, оповещающее о том, что заказ оформлен, Вы должны занести данное событие в статистику своего сайта.

Если Вы хотите автоматически заносить события, произошедшие вне Вашего сайта, то сделать это можно, загружая PHP-страницу, адрес которой формируется по следующей формуле:

http://[ВАШСАЙТ]/bitrix/admin/event_edit.php?

        USER_LOGIN=[ЛОГИН]&USER_PASSWORD=[ПАРОЛЬ]&lang=[САЙТ]&
        Login=Y&TYPE=AUTH&AUTH_FORM=Y&
        ARR[]=[N]&LOAD_[N]=Y&EVENT_ID_[N]=[ID типа]&EVENT3_[N]=[EVENT3]&
        DATE_ENTER_[N]=[ДАТА]&PARAM_[N]= [ПАРАМЕТР]]&MONEY_[N]=[ДЕНЕЖНАЯСУММА]&
        CHARGEBACK_[N]=[ФЛАГВОЗВРАТАДЕНЕГ]&
        ARR[]=[N+1]]&LOAD_[N+1]=Y&EVENT_ID_[N+1]=[ID типа]&EVENT3_[N+1]=[EVENT3]&
        DATE_ENTER_[N+1]=[ДАТА]&PARAM_[N+1]= [ПАРАМЕТР]&MONEY_[N+1]=[ДЕНЕЖНАЯСУММА]&
        CHARGEBACK_[N]=[ФЛАГВОЗВРАТАДЕНЕГ]&
...
        ARR[]=[M]&]&LOAD_[M]=Y&EVENT_ID_[M]=[ID типа]&EVENT3_[M]=[EVENT3]&
        DATE_ENTER_[M]=[ДАТА]&PARAM_[M]= [ПАРАМЕТР]&MONEY_[M]=[ДЕНЕЖНАЯСУММА]&
        CHARGEBACK_[N]=[ФЛАГВОЗВРАТАДЕНЕГ]

&check_unique=Y&save=Y

В данной формуле:

[ВАШСАЙТ] – адрес сайта;
[ЛОГИН] – логин пользователя, имеющего право Запись для модуля статистики;
[ПАРОЛЬ] – пароль вышеописанного пользователя;
[САЙТ] – сайт, в формате которого будет задана дата события (например, ru);
[N], [N+1] – порядковый номер загружаемого события;
[M] – количество загружаемых событий;
[IDтипа] – ID типа загружаемого события;
[EVENT3] – дополнительный параметр события;
[ДАТА] – дата события в формате заданного сайта;
[ПАРАМЕТР] – параметр в формате:
[Код сайта].[ID сессии].[ID посетителя].[ID страны].[ID рекламной кампании].[Y – возврат по рекламной кампании; N – прямой заход];
[MONEY] – денежная сумма события;
[CHARGEBACK] – флаг возврата денег: Y – денежную сумму необходимо отнять от доходов рекламной кампании; N – денежную сумму необходимо прибавить к доходам компании (по умолчанию).
check_unique – для проверки уникальности загружаемых событий значение данного параметра должно быть Y, в противном случае уникальность проверяться не будет.

Пример адреса

http://www.1c-bitrix.ru/bitrix/admin/event_edit.php?
       USER_LOGIN=admin&USER_PASSWORD=123456&lang=ru&Login=Y&
       TYPE=AUTH&AUTH_FORM=Y&ARR[]=1&LOAD_1=Y&EVENT_ID_1=35&
       EVENT3_1=250&DATE_ENTER_1=10.01.2007&PARAM_1=BITRIX_SM.10345.676.US.3.Y&
       ARR[]=2&LOAD_2=Y&EVENT_ID_2=35&EVENT3_2=340&DATE_ENTER_2=11.01.2007&
       PARAM_2= BITRIX_SM.10400.700.RU.5.N&MONEY_2=970.35&check_unique=Y&save=Y

Внимание
Пример представлен не в кодированном виде. Для корректной работы страницы вам необходимо для значений параметров ссылки применять URL- кодирование (в PHP - функция urlencode()).

1С-Битрикс: Управление сайтом