Intermediação de solicitações via proxy

Uma das tarefas do SDK é enviar solicitações para o Finteza por meio de seu site. Mais informações estão disponíveis na seção 'Redirecionando scripts e solicitações via proxy'.

Para habilitar a intermediação de solicitações via proxy, defina seus parâmetros além dos principais no método de inicialização ConfigureServices:

services.AddFintezaAnalytics(options =>
{
    options.WebsiteId = "{WEBSITE_ID}";
    options.Token = "{Token}";
    options.Path = "{Path}";
...
});

Parâmetros	Tipo	Descrição
Token *	string	Token para assinatura de cabeçalho X-Forwarded-For. Você pode obter esse valor no painel do Finteza nas configurações do site: abra a seção Contador, ative a opção 'Redirecionar script e solicitações' e copie o valor do campo 'Token proxy'. Ao redirecionar via proxy, todas as solicitações para o Finteza são enviadas fisicamente do servidor do seu site e não, diretamente dos clientes. Para enviar para o Finteza endereços IP reais de clientes (e não apenas o endereço do site), o SDK usa o cabeçalho X-Forwarded-For. Para evitar fraudes no tráfego, falsificando solicitações, e informar apenas dados reais sobre visitas, o Finteza verifica a assinatura dos cabeçalhos nas solicitações. Se o cabeçalho for assinado por um token exclusivo do site, o sistema confiará em seus valores, caso contrário, o tráfego será considerado como fraudulento (relatórios de tráfego estão disponíveis na seção Qualidade, no painel do Finteza)
Path	string	Inicio do caminho para solicitações a serem intermediadas via proxy. Se o parâmetro não for especificado, será usado um valor por padrão – /fz. Em seguida serão descritas alterações no código de acompanhamento, de modo que todas as solicitações para o Finteza sejam executadas ao longo dos caminhos com esse mesmo começo.

Parâmetros

Tipo

Descrição

Token *

string

Token para assinatura de cabeçalho X-Forwarded-For. Você pode obter esse valor no painel do Finteza nas configurações do site: abra a seção Contador, ative a opção 'Redirecionar script e solicitações' e copie o valor do campo 'Token proxy'.

Ao redirecionar via proxy, todas as solicitações para o Finteza são enviadas fisicamente do servidor do seu site e não, diretamente dos clientes. Para enviar para o Finteza endereços IP reais de clientes (e não apenas o endereço do site), o SDK usa o cabeçalho X-Forwarded-For.

Para evitar fraudes no tráfego, falsificando solicitações, e informar apenas dados reais sobre visitas, o Finteza verifica a assinatura dos cabeçalhos nas solicitações. Se o cabeçalho for assinado por um token exclusivo do site, o sistema confiará em seus valores, caso contrário, o tráfego será considerado como fraudulento (relatórios de tráfego estão disponíveis na seção Qualidade, no painel do Finteza)

Path

string

Inicio do caminho para solicitações a serem intermediadas via proxy. Se o parâmetro não for especificado, será usado um valor por padrão – /fz.

Em seguida serão descritas alterações no código de acompanhamento, de modo que todas as solicitações para o Finteza sejam executadas ao longo dos caminhos com esse mesmo começo.

* – parâmetros obrigatórios.

Exemplo:

services.AddFintezaAnalytics(options =>
{
    options.WebsiteId = "opemapikpuymgukzpihgweylppotinamyf";
    options.Token = "joanmxozikjgeqlgguazmzoplankaqlg";
    options.Path = "/fz";
...
});

Mais adiante no método Configure da classe Startup adicione a linha:

app.UseFintezaAnalyticsProxy();

Método UseFintezaAnalyticsProxy irá criar uma camada especial. Ela roteará independentemente as solicitações recebidas e redirecionará via proxy somente solicitações analíticas para o Finteza.

Atenção: depois de configurar o proxy, faça alterações no código de acompanhamento.