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

Форма Загрузка событий (Аналитика > События > Загрузка событий) предназначена для занесения в базу данных событий, произошедших вне сайта. Примерами таких событий могут служить оплата заказа, отмена заказа и т.п.

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

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

10,"file1.exe","10.10.2007 12:30","BITRIX_SM.10.5.RU.6.Y","250"
11,"help_doc.chm","10.10.2007 12:30"
12,"www","10.10.2007 12:30","BITRIX_SM.11.4.US.8.N","233.45"
13,"1C-Битрикс: Корпоративный портал","10.10.2007 12:30","BITRIX_SM.11.4.US.8.N","233.45",,"Y"

Ручной ввод

Таблица служит для ручного ввода событий в базу данных.

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

* - поле, обязательное для заполнения.

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

Когда посетитель уходит, например, на оформление заказа, то в ссылку, ведущую на внешнюю платежную систему, должен быть добавлен специальный шаблон – #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()).