IntegraçãoFinteza SDKServidores da Web ASP.NET CoreEnviando eventos

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.

Você está perdendo dados analíticos sem o Finteza

Ao contrário dos sistemas analíticos gratuitos, o Finteza registra 100% dos dados do visitante em seu site.

Registre-se agora e tenha acesso gratuito por 30 dias.

Ao se registrar, você concorda com os Termos do Acordo
Parabéns, conta criada com sucesso!
  • Visite
    finteza.com
  • Obter
    conta
  • Confirmar
    e-mail
  • Instalar
    código

Enviamos um e-mail de ativação de conta para {email}.

Depois disso, você pode fazer login e tudo o que resta é instalar o código de rastreamento no site, é simples: