Отправка событий

SDK позволяет отправлять в Finteza любые события с серверной части вашего сайта: информацию о действиях пользователей, состоянии базы, показатели производительности и т.д. Для этого предусмотрен метод Finteza.Tracker.SendEvent.

Finteza.Tracker.SendEvent("{EVENT}");

При помощи него вы можете не только регистрировать сами события, но и передавать дополнительную информацию в виде параметров. Например, вид приобретенного товара, сумму покупки, валюту и т.д. Поддерживаются следующие параметры:

Параметр	Тип	Описание
name *	string	Название события. Максимальная длина составляет 128 символов.
referer *	string	Адрес страницы, с которой отправляется событие. Все события привязываются к счетчикам (сайтам) на стороне Finteza по идентификатору websiteId. При этом система дополнительно проверяет, чтобы хост, с которого пришло событие, соответствовал хосту счетчика (указываются в настройках сайта в панели Finteza). Это позволяет предотвратить накрутку трафика.
backReferer	string	Адрес страницы, на которой находился посетитель до выполнения отслеживаемого действия.
userIp	string	IP-адрес посетителя, выполнившего отслеживаемое действие.
userAgent	string	User-agent посетителя, выполнившего отслеживаемое действие.
unit	string	Единицы измерения параметра. Например, USD, штуки и т.д. Максимальная длина 32 символа.
value	string	Значение параметра. Максимальная длина 64 символа.

* — обязательные параметры.

Пример:

Finteza.Tracker.SendEvent("Server Track Purchase", "https://www.mysite.com", "USD", "100");

Чтобы не указывать параметр referer при каждой отправке события, задайте его значение по умолчанию при инициализации. При вызове Finteza.RegisterAnalytics укажите дополнительный параметр defaultReferer:

Finteza.RegisterAnalytics(websiteId: "{WEBSITE_ID}", defaultReferer: "{DEFAULT_REFERER}");

Важно: Если вы не используете defaultReferer, указывайте referer при каждом вызове SendEvent. В ином случае события не будут отправляться.

Для функции Finteza.Tracker.SendEvent доступен еще один вариант:

Finteza.Tracker.SendEvent({CONTEXT}, "{EVENT}");

Здесь вместо явного указания referer, backReferer, userIp, userAgent задается контекст исполнения запроса, из которого указанные параметры будут получены и отправлены в Finteza.

Параметр	Тип	Описание
httpContext *	System.Web.HttpContextBase или System.Web.HttpContext	Контекст выполнения текущего HTTP-запроса, из которого автоматически сформируются параметры referer, backReferer, userIp и userAgent.
name *	string	Название события. Максимальная длина составляет 128 символов.
unit	string	Единицы измерения параметра. Например, USD, штуки и т.д. Максимальная длина 32 символа.
value	string	Значение параметра. Максимальная длина 64 символа.

* — обязательные параметры.