Envío de eventos

El SDK permite enviar a Finteza cualquier evento desde la parte del servidor de su sistio web: información sobre las acciones de los usuarios, estado de la base de datos, indicadores de productividad, etcétera. Para ello, se ha diseñado el método Finteza.Tracker.SendEvent.

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

Con la ayuda del mismo, usted podrá no solo registrar los propios eventos, sino también transmitir información adicional en forma de parámetros. Por ejemplo, el tipo de mercancía adquirida, el importe de la compra, la divisa, etcétera. Se soportan los parámetros siguientes:

Parámetro	Tipo	Descripción
name *	string	Nombre del evento. La longitud máxima es de 128 símbolos.
referer	string	Dirección de la página desde la que se envía el evento. Todos los eventos se vinculan a los contadores (sitios web) en el lado de Finteza según el identificador websiteId. En este caso, además, se comprueba adicionalmente que el huésped desde el que ha llegado el evento se corresponda con el huésped del contador (se indican en los ajustes del sitio web, en el panel de Finteza). Esto permite prevenir el aumento fraudulento de tráfico.
backReferer	string	Dirección de la página en la que se encontraba el visitante antes de ejecutar la acción monitoreada.
userIp	string	Dirección IP del visitante que ha ejecutado la acción monitoreada.
userAgent	string	User-agent del visitante que ha ejecutado la acción monitoreada.
unit	string	Unidades de medida del parámetro. Por ejemplo, USD, unidades, etcétera. Su longitud máxima es de 32 símbolos.
value	string	Valor del parámetro. Su longitud máxima es de 64 símbolos.

* – parámetros obligatorios.

Ejemplo:

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

Para indicar el parámetro referer con cada envío del evento, establezca este parámetro por defecto en la inicialización. Al llamar a Finteza.RegisterAnalytics, indique el parámetro adicional defaultReferer:

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

Importante: Si usted no utiliza defaultReferer, indique referer en cada llamada de SendEvent. En caso contrario, los eventos no serán enviados.

Para la función Finteza.Tracker.SendEvent está disponible una opción adicional:

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

Aquí, en lugar de indicar explícitamente referer, backReferer, userIp, userAgent, se establece el contexto de ejecución de la solicitud que se utilizará para obtener y enviar los parámetros indicados a Finteza.

Parámetro	Tipo	Descripción
httpContext *	System.Web.HttpContextBase o System.Web.HttpContext	Contexto de ejecución de la solicitud HTTP actual que se utilizará para formar automáticamente los parámetros referer, backReferer, userIp y userAgent.
name *	string	Nombre del evento. La longitud máxima es de 128 símbolos.
unit	string	Unidades de medida del parámetro. Por ejemplo, USD, unidades, etcétera. Su longitud máxima es de 32 símbolos.
value	string	Valor del parámetro. Su longitud máxima es de 64 símbolos.

* – parámetros obligatorios.