Enviando eventos

O SDK permite enviar para o Finteza qualquer evento do lado do servidor de seu site: informações sobre ações do usuário, status do banco de dados, indicadores de desempenho, etc. Para isso, é fornecido o método Finteza.Tracker.SendEvent.

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

Com ele, você pode não apenas registrar os próprios eventos, mas também passar informações adicionais na forma de parâmetros. Por exemplo, o tipo de mercadoria comprada, o valor da compra, a moeda, etc. São suportados os seguintes parâmetros:

Parâmetros	Tipo	Descrição
name *	string	Nome do evento. O tamanho máximo é de 128 caracteres.
referer	string	O endereço da página da qual o evento é enviado. Todos os eventos estão ligados a contadores (sites) no lado do Finteza com base no identificador websiteId. Além disso, o sistema verifica adicionalmente se o host do qual chega o evento corresponde ao host do contador (especificado nas configurações do site no painel do Finteza). Isso ajuda a evitar o tráfego fraudulento.
backReferer	string	Endereço da página em que o visitante estava antes de a ação monitorada ser executada.
userIp	string	Endereço IP do visitante que executou a ação monitorada.
userAgent	string	User-agent do visitante que executou a ação monitorada.
unit	string	Unidades do parâmetro. Por exemplo, USD, peças, etc. Comprimento máximo de 32 caracteres.
value	string	Valor do parâmetro Comprimento máximo de 64 caracteres.

* – parâmetros obrigatórios.

Exemplo:

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

Para não especificar o parâmetro referer cada vez que um evento é enviado, defina seu valor por padrão ao realizar a inicialização. Ao chamar Finteza.RegisterAnalytics especifique o parâmetro adicional defaultReferer:

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

Importante: Se você não usa defaultReferer, especifique referer com cada chamada de SendEvent. Caso contrário, os eventos não serão enviados.

Para a função Finteza.Tracker.SendEvent está disponível outra variação:

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

Aqui, em vez de indicar explicitamente referer, backReferer, userIp, userAgent, é definido o contexto de execução da solicitação, a partir da qual os parâmetros especificados serão recebidos e enviados para o Finteza.

Parâmetros	Tipo	Descrição
httpContext *	System.Web.HttpContextBase или System.Web.HttpContext	Contexto de execução da solicitação HTTP atual, a partir da qual são gerados automaticamente os parâmetros referer, backReferer, userIp e userAgent.
name *	string	Nome do evento. O tamanho máximo é de 128 caracteres.
unit	string	Unidades do parâmetro. Por exemplo, USD, peças, etc. Comprimento máximo de 32 caracteres.
value	string	Valor do parâmetro Comprimento máximo de 64 caracteres.

* – parâmetros obrigatórios.