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.

Chame o método ITracker.SendEvent. Para fazer isso, obtenha a implementação ITracker com ajuda da "Injeção de dependência" Por exemplo, por meio de injeção no construtor:

class SomeClass
{
    public SomeClass(ITracker tracker)
    {
        tracker.SendEvent("{EVENT}");
    }
}

Com ajuda do métodoSendEvent 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. Os seguintes parâmetros são suportados:

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:

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 AddFintezaAnalytics, especifique o parâmetro adicional DefaultReferer:

services.AddFintezaAnalytics(options =>
{
options.WebsiteId = "{WEBSITE_ID}";
options.DefaultReferer = "{DEFAULT_REFERER}";
...
});

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

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

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 *	Microsoft.AspNetCore.Http.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.